Merge branch 'develop' into fix-postinstall-script

Author: odilitime

.devcontainer/Dockerfile

@@ -0,0 +1,24 @@
+ARG NODE_VER=23.5.0
+ARG BASE_IMAGE=node:${NODE_VER}
+FROM $BASE_IMAGE
+
+ENV DEBIAN_FRONTEND=noninteractive
+
+# Install pnpm globally and install necessary build tools
+RUN apt-get update \
+    && apt-get install -y \
+    git \
+    python3 \
+    make \
+    g++ \
+    nano \
+    vim \
+    && apt-get clean \
+    && rm -rf /var/lib/apt/lists/*
+
+ARG PNPM_VER=9.15.2
+RUN npm install -g pnpm@${PNPM_VER}
+
+# Set Python 3 as the default python
+RUN ln -s /usr/bin/python3 /usr/bin/python
+ENV DEBIAN_FRONTEND=dialog

.devcontainer/devcontainer.json

@@ -0,0 +1,38 @@
+// See https://aka.ms/vscode-remote/devcontainer.json for format details.
+{
+    "name": "elizaos-dev",
+    "dockerFile": "Dockerfile",
+    "build": {
+        "args": {
+            "NODE_VER": "23.5.0",
+            "PNPM_VER": "9.15.2"
+        }
+    },
+    "privileged": true,
+    "runArgs": [
+        "-p=3000:3000", // Add port for server api
+        "-p=5173:5173", // Add port for client
+        //"--volume=/usr/lib/wsl:/usr/lib/wsl", // uncomment for WSL
+        //"--volume=/mnt/wslg:/mnt/wslg", // uncomment for WSL
+        "--gpus=all", // ! uncomment for vGPU
+        //"--device=/dev/dxg", // uncomment this for vGPU under WSL
+        "--device=/dev/dri"
+    ],
+    "containerEnv": {
+        //"MESA_D3D12_DEFAULT_ADAPTER_NAME": "NVIDIA", // uncomment for WSL
+        //"LD_LIBRARY_PATH": "/usr/lib/wsl/lib" // uncomment for WSL
+    },
+    "customizations": {
+        "vscode": {
+            "extensions": [
+                "vscode.json-language-features",
+                "vscode.css-language-features",
+                // "foxundermoon.shell-format",
+                // "dbaeumer.vscode-eslint",
+                // "esbenp.prettier-vscode"
+                "ms-python.python"
+            ]
+        }
+    },
+    "features": {}
+}

.gitignore

@@ -50,6 +50,7 @@ tsup.config.bundled_*.mjs
 
 .turbo
 .cursorrules
+.pnpm-store
 
 coverage
 .eslintcache

README.md

@@ -12,7 +12,7 @@
 
 ## 🌍 README Translations
 
-[中文说明](./README_CN.md) | [日本語の説明](./README_JA.md) | [한국어 설명](./README_KOR.md) | [Français](./README_FR.md) | [Português](./README_PTBR.md) | [Türkçe](./README_TR.md) | [Русский](./README_RU.md) | [Español](./README_ES.md) | [Italiano](./README_IT.md) | [ไทย](./README_TH.md) | [Deutsch](./README_DE.md) | [Tiếng Việt](./README_VI.md) | [עִברִית](https://github.com/elizaos/Elisa/blob/main/README_HE.md) | [Tagalog](./README_TG.md) | [Polski](./README_PL.md) | [Arabic](./README_AR.md) | [Hungarian](./README_HU.md) | [Srpski](./README_RS.md)
+[中文说明](./README_CN.md) | [日本語の説明](./README_JA.md) | [한국어 설명](./README_KOR.md) | [Français](./README_FR.md) | [Português](./README_PTBR.md) | [Türkçe](./README_TR.md) | [Русский](./README_RU.md) | [Español](./README_ES.md) | [Italiano](./README_IT.md) | [ไทย](./README_TH.md) | [Deutsch](./README_DE.md) | [Tiếng Việt](./README_VI.md) | [עִברִית](https://github.com/elizaos/Elisa/blob/main/README_HE.md) | [Tagalog](./README_TG.md) | [Polski](./README_PL.md) | [Arabic](./README_AR.md) | [Hungarian](./README_HU.md) | [Srpski](./README_RS.md) | [Română](./README_RO.md)
 
 ## 🚩 Overview
 

README_RO.md

@@ -0,0 +1,183 @@
+# Eliza
+
+<img src="./docs/static/img/eliza_banner.jpg" alt="Eliza Banner" width="100%" />
+
+## Funcționalități
+
+-   🛠 Conectori compleți pentru Discord, Twitter și Telegram
+-   👥 Suport pentru agenți multipli și camere
+-   📚 Ingestie și interacțiune ușoară cu documentele tale
+-   💾 Memorie recuperabilă și stocare de documente
+-   🚀 Extensibil în mod ridicat – creează propriile acțiuni și clienți pentru a extinde capacitățile
+-   ☁️ Suportă multe modele, inclusiv Llama local, OpenAI, Anthropic, Groq și altele
+-   📦 Funcționează perfect!
+
+## Pentru ce pot să-l folosesc?
+
+-   🤖 Chatbot-uri
+-   🕵️ Agenți autonomi
+-   📈 Gestiunea proceselor de afaceri
+-   🎮 NPC-uri în jocuri video
+
+# Început
+
+**Cerințe preliminare (OBLIGATORIU):**
+
+-   [Python 2.7+](https://www.python.org/downloads/)
+-   [Node.js 23.3+](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm)
+-   [pnpm](https://pnpm.io/installation)
+
+### Edite fișierul .env
+
+-   Copiați `.env.example` în `.env` și completați valorile corespunzătoare
+-   Editați variabilele de mediu pentru TWITTER pentru a adăuga numele de utilizator și parola botului dvs.
+
+### Edite fișierul de personaj
+
+-   Verificați fișierul `src/core/defaultCharacter.ts` – îl puteți modifica
+-   De asemenea, puteți încărca personaje cu comanda `pnpm start --characters="path/to/your/character.json"` și rula mai mulți boți în același timp.
+
+După ce ați configurat fișierul .env și fișierul de personaj, puteți porni botul cu următoarea comandă:
+
+```
+pnpm i
+pnpm start
+```
+
+# Personalizarea Eliza
+
+### Adăugarea de acțiuni personalizate
+
+Pentru a evita conflicte în directorul core, vă recomandăm să adăugați acțiuni personalizate într-un director `custom_actions` și apoi să le includeți în fișierul `elizaConfig.yaml`. Consultați fișierul `elizaConfig.example.yaml` pentru un exemplu.
+
+## Rularea cu modele diferite
+
+### Rularea cu Llama
+
+Puteți rula modele Llama 70B sau 405B setând variabila de mediu `XAI_MODEL` la `meta-llama/Meta-Llama-3.1-70B-Instruct-Turbo` sau `meta-llama/Meta-Llama-3.1-405B-Instruct`.
+
+### Rularea cu Grok
+
+Puteți rula modele Grok setând variabila de mediu `XAI_MODEL` la `grok-beta`.
+
+### Rularea cu OpenAI
+
+Puteți rula modele OpenAI setând variabila de mediu `XAI_MODEL` la `gpt-4o-mini` sau `gpt-4o`.
+
+## Cerințe suplimentare
+
+Este posibil să fie necesară instalarea Sharp. Dacă întâmpinați o eroare la pornire, încercați să îl instalați cu următoarea comandă:
+
+```
+pnpm install --include=optional sharp
+```
+
+# Configurarea mediului
+
+Va trebui să adăugați variabile de mediu în fișierul dvs. `.env` pentru a vă conecta la diverse platforme:
+
+```
+# Variáveis de ambiente obrigatórias
+DISCORD_APPLICATION_ID=
+DISCORD_API_TOKEN= # Token do bot
+OPENAI_API_KEY=sk-* # Chave API do OpenAI, começando com sk-
+ELEVENLABS_XI_API_KEY= # Chave API do elevenlabs
+GOOGLE_GENERATIVE_AI_API_KEY= # Chave API do Gemini
+
+# CONFIGURAÇÕES DO ELEVENLABS
+ELEVENLABS_MODEL_ID=eleven_multilingual_v2
+ELEVENLABS_VOICE_ID=21m00Tcm4TlvDq8ikWAM
+ELEVENLABS_VOICE_STABILITY=0.5
+ELEVENLABS_VOICE_SIMILARITY_BOOST=0.9
+ELEVENLABS_VOICE_STYLE=0.66
+ELEVENLABS_VOICE_USE_SPEAKER_BOOST=false
+ELEVENLABS_OPTIMIZE_STREAMING_LATENCY=4
+ELEVENLABS_OUTPUT_FORMAT=pcm_16000
+
+TWITTER_DRY_RUN=false
+TWITTER_USERNAME= # Nome de usuário da conta
+TWITTER_PASSWORD= # Senha da conta
+TWITTER_EMAIL= # Email da conta
+
+X_SERVER_URL=
+XAI_API_KEY=
+XAI_MODEL=
+
+
+# Para perguntar coisas ao Claude
+ANTHROPIC_API_KEY=
+
+# EVM
+EVM_PRIVATE_KEY=EXAMPLE_WALLET_PRIVATE_KEY
+
+# Solana
+SOLANA_PRIVATE_KEY=EXAMPLE_WALLET_PRIVATE_KEY
+SOLANA_PUBLIC_KEY=EXAMPLE_WALLET_PUBLIC_KEY
+
+# Fallback Wallet Configuration (deprecated)
+WALLET_PRIVATE_KEY=EXAMPLE_WALLET_PRIVATE_KEY
+WALLET_PUBLIC_KEY=EXAMPLE_WALLET_PUBLIC_KEY
+
+BIRDEYE_API_KEY=
+
+SOL_ADDRESS=So11111111111111111111111111111111111111112
+SLIPPAGE=1
+RPC_URL=https://api.mainnet-beta.solana.com
+HELIUS_API_KEY=
+
+
+## Telegram
+TELEGRAM_BOT_TOKEN=
+
+TOGETHER_API_KEY=
+```
+
+# Configurarea inferenței locale
+
+### Configurarea CUDA
+
+Dacă aveți un GPU NVIDIA, puteți instala CUDA pentru a accelera dramatic inferența locală.
+
+```
+pnpm install
+npx --no node-llama-cpp source download --gpu cuda
+```
+
+Asigurați-vă că ați instalat CUDA Toolkit, inclusiv cuDNN și cuBLAS.
+
+### Rularea locală
+
+Adăugați `XAI_MODEL` și setați-l la una dintre opțiunile de mai sus din [Rularea cu Llama](#rularea-cu-llama) – puteți lăsa `X_SERVER_URL` și `XAI_API_KEY` necompletate, modelul va fi descărcat de pe Hugging Face și interogările vor fi făcute local.
+
+# Clienți
+
+## Bot Discord
+
+Pentru ajutor la configurarea Bot-ului Discord, consultați: https://discordjs.guide/preparations/setting-up-a-bot-application.html
+
+# Dezvoltare
+
+## Teste
+
+Pentru a rula suita de teste:
+
+```bash
+pnpm test           # Execută testele o dată
+pnpm test:watch    # Execută testele în modul watch
+```
+
+Pentru teste specifice bazei de date:
+
+```bash
+pnpm test:sqlite   # Execută testele cu SQLite
+pnpm test:sqljs    # Execută testele cu SQL.js
+```
+
+Testele sunt scrise folosind Jest și pot fi găsite în fișierele `src/**/*.test.ts`. Mediul de testare este configurat pentru:
+
+-   Încărcarea variabilelor de mediu din `.env.test`
+-   Utilizarea unui timeout de 2 minute pentru teste de lungă durată
+-   Suport pentru module ESM
+-   Rularea testelor în secvență (`--runInBand`)
+
+Pentru a crea teste noi, adăugați un fișier `.test.ts` adiacent codului pe care îl testați.

docs/docs/guides/local-development.md

@@ -8,37 +8,61 @@ This guide covers setting up and working with Eliza in a development environment
 
 ## Prerequisites
 
-Before you begin, ensure you have:
+You can develop either in a **dev container** or directly on your **host machine**.
+
+### Requirements:
 
 ```bash
 # Required
-Node.js 23+
-pnpm
+Node.js (v23+; not required if using the dev container)
+pnpm (not required if using the dev container)
 Git
 
-# Optional but recommended
-VS Code
-Docker (for database development)
-CUDA Toolkit (for GPU acceleration)
+VS Code (mandatory for using the dev container or coding)
+Docker (mandatory for using the dev container or database development)
+CUDA Toolkit (optional, for GPU acceleration)
 ```
 
 ## Initial Setup
 
 ### 1. Repository Setup
 
+Clone the repository and navigate to the project directory:
+
 ```bash
 # Clone the repository
 git clone https://github.com/elizaos/eliza.git
 cd eliza
+```
+
+### 2. (Optional) Run Inside a Dev Container
+
+1. Open the project directory in **VS Code**:
+   ```bash
+   code .
+   ```
+
+2. In the bottom-right corner, you'll see a popup:
+   **"Reopen in Container"** – Click it.
+
+   - If you don't see the popup or miss it, press `F1`, type:
+     **"Reopen in Container"**, and select it.
+
+3. Wait for the container to initialize.
 
+4. Open a terminal (hotkey: `Ctrl+Shift+\``) and run commands from the **container terminal** going forward.
+
+### 3. Setup dependencies
+
+```bash
 # Install dependencies
 pnpm install
 
 # Install optional dependencies
 pnpm install --include=optional sharp
 ```
 
-### 2. Environment Configuration
+### 4. Environment Configuration
 
 Create your development environment file:
 
@@ -56,7 +80,7 @@ XAI_API_KEY=                 # Leave blank for local inference
 XAI_MODEL=meta-llama/Llama-3.1-7b-instruct  # Local model
 ```
 
-### 3. Local Model Setup
+### 5. Local Model Setup
 
 For local inference without API dependencies:
 
@@ -106,10 +130,16 @@ pnpm run dev --characters="characters/my-character.json"
 pnpm start:client
 ```
 
+NOTE: If you are using devcontainer, add --host argument to client:
+```
+pnpm start:client --host
+```
+
 Look for the message:
 `  ➜  Local:   http://localhost:5173/`
 Click on that link or open a browser window to that location. Once you do that you should see the chat interface connect with the system and you can start interacting with your character.
 
+
 ## Database Development
 
 ### SQLite (Recommended for Development)