diff --git a/README.md b/README.md new file mode 100644 index 0000000000..5875086110 --- /dev/null +++ b/README.md @@ -0,0 +1,150 @@ +# Eliza 🤖 + +
+ Eliza Banner +
+ +
+ +📖 [Documentation](https://elizaos.github.io/eliza/) | 🎯 [Examples](https://github.com/thejoven/awesome-eliza) + +
+ +## 🌍 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) + +## 🚩 Overview + +
+ Eliza Diagram +
+ +## ✨ Features + +- 🛠️ Full-featured Discord, Twitter and Telegram connectors +- 🔗 Support for every model (Llama, Grok, OpenAI, Anthropic, etc.) +- 👥 Multi-agent and room support +- 📚 Easily ingest and interact with your documents +- 💾 Retrievable memory and document store +- 🚀 Highly extensible - create your own actions and clients +- ☁️ Supports many models (local Llama, OpenAI, Anthropic, Groq, etc.) +- 📦 Just works! + +## Video Tutorials + +[AI Agent Dev School](https://www.youtube.com/watch?v=ArptLpQiKfI&list=PLx5pnFXdPTRzWla0RaOxALTSTnVq53fKL) + +## 🎯 Use Cases + +- 🤖 Chatbots +- 🕵️ Autonomous Agents +- 📈 Business Process Handling +- 🎮 Video Game NPCs +- 🧠 Trading + +## 🚀 Quick Start + +### Prerequisites + +- [Python 2.7+](https://www.python.org/downloads/) +- [Node.js 23+](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) +- [pnpm](https://pnpm.io/installation) + +> **Note for Windows Users:** [WSL 2](https://learn.microsoft.com/en-us/windows/wsl/install-manual) is required. + +### Use the Starter (Recommended) + +```bash +git clone https://github.com/elizaos/eliza-starter.git +cd eliza-starter +cp .env.example .env +pnpm i && pnpm build && pnpm start +``` + +Once the agent is running, you should see the message to run "pnpm start:client" at the end. +Open another terminal and move to same directory and then run below command and follow the URL to chat to your agent. + +```bash +pnpm start:client +``` + +Then read the [Documentation](https://elizaos.github.io/eliza/) to learn how to customize your Eliza. + +### Manually Start Eliza (Only recommended if you know what you are doing) + +```bash +# Clone the repository +git clone https://github.com/elizaos/eliza.git + +# Checkout the latest release +# This project iterates fast, so we recommend checking out the latest release +git checkout $(git describe --tags --abbrev=0) +``` + +### Start Eliza with Gitpod + +[![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/elizaos/eliza/tree/main) + +### Edit the .env file + +Copy .env.example to .env and fill in the appropriate values. + +``` +cp .env.example .env +``` + +Note: .env is optional. If you're planning to run multiple distinct agents, you can pass secrets through the character JSON +Note: .env is optional. If you're planning to run multiple distinct agents, you can pass secrets through the character JSON + +### Automatically Start Eliza + +This will run everything to set up the project and start the bot with the default character. + +```bash +sh scripts/start.sh +``` + +### Edit the character file + +1. Open `packages/core/src/defaultCharacter.ts` to modify the default character. Uncomment and edit. + +2. To load custom characters: + - Use `pnpm start --characters="path/to/your/character.json"` + - Multiple character files can be loaded simultaneously +3. Connect with X (Twitter) + - change `"clients": []` to `"clients": ["twitter"]` in the character file to connect with X + +### Manually Start Eliza + +```bash +pnpm i +pnpm build +pnpm start + +# The project iterates fast, sometimes you need to clean the project if you are coming back to the project +pnpm clean +``` + +#### Additional Requirements + +You may need to install Sharp. If you see an error when starting up, try installing it with the following command: + +``` +pnpm install --include=optional sharp +``` + +### Community & contact + +- [GitHub Issues](https://github.com/elizaos/eliza/issues). Best for: bugs you encounter using Eliza, and feature proposals. +- [Discord](https://discord.gg/ai16z). Best for: sharing your applications and hanging out with the community. + +## Contributors + + + + + +## Star History + +[![Star History Chart](https://api.star-history.com/svg?repos=elizaos/eliza&type=Date)](https://star-history.com/#elizaos/eliza&Date) diff --git a/README_AR.md b/README_AR.md new file mode 100644 index 0000000000..c2597ebf7b --- /dev/null +++ b/README_AR.md @@ -0,0 +1,133 @@ +# Eliza 🤖 + +
+ Eliza Banner +
+ +
+ +📖 [التعليمات](https://elizaos.github.io/eliza/) | 🎯 [الأمثلة](https://github.com/thejoven/awesome-eliza) + +
+ +## ✨ ما هي الميزات؟ + +- 🛠️ اتصالات مجهزة بالكامل لديسكورد، تويتر، وتيليغرام. +- 👥 دعم متعدد للوكلاء والغرف. +- 📚 التفاعل بإتقان مع المستندات كما يمكن فحصها بسهولة. +- 💾 ذاكرة قوية قابلة لاسترجاع ما فاتك! وكذلك مساحة كافية للتخزين +- 🚀 سريعة الانتشار بشكل غير مسبوق، هيّا! تفاعل واصنع عملاء خاصين بك. +- ☁️ تدعم العديد من النماذج مثل:- + - لاما (نموذج مفتوح المصدر للذكاء الاصطناعي Llama). + - جروك (نظام ذكاء اصطناعي متقدم Grok). + - أوبن إيه آي (OpenAI نماذج ذكاء اصطناعي مثل ChatGPT). + - أنثروبيك Anthropic وغيرها من النماذج الأخرى! +- 📦 جاهزة للعمل أي وقت وبسهولة! + +## 🎯 كيف ستفيدني؟ + +- 🤖 روبوتات الدردشة. +- 🕵️ وكلاء مستقلون. +- 📈 إدارة الأعمال. +- 🎮 في الجيميز NPCs أو الشخصيات التي يتحكم بها الحاسوب فقط وليس اللاعب. +- 🧠 التداول. + +## 🚀 ابدأ الآن! + +### ماذا عن المتطلبات الأساسية؟ + +- [Python 2.7+](https://www.python.org/downloads/) +- [Node.js 23+](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) +- [pnpm](https://pnpm.io/installation) + +> **لمتسخدمي الويندوز يجب أن يكون لديك نظام ويندوز الفرعي للينكس:** [WSL 2](https://learn.microsoft.com/de-de/windows/wsl/install-manual). + +### استخدام النسخة المبدئية (موصى به) + +```bash +git clone https://github.com/elizaos/eliza-starter.git + +cp .env.example .env + +pnpm i && pnpm start +``` + +تعلم أكثر عن كيفية تخصيص إليزا من هنا [التعليمات](https://elizaos.github.io/eliza/) + +### إذا كان لديك خبرة بالفعل، يُمكنك تشغيل إليزا يدويًا. + +```bash +# انشئ نسخة +git clone https://github.com/elizaos/eliza.git + +# ألق نظرة على آخر تحديث +# هذا المشروع يتطور بسرعة، لذا، أوصيك باستخدام أحدث إصدار +git checkout $(git describe --tags --abbrev=0) +``` + +### تشغل إليزا مع Gitpod + +[![In Gitpod öffnen](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/elizaos/eliza/tree/main) + +### عدّل ملف .env-Datei + +انسخ ملف .env.example إلى .env واملأ القيم المناسبة. + +``` +cp .env.example .env +``` + +ضع في الإعتبار أن ملف .env اختياري. إذا كنت تخطط لتشغيل عدة وكلاء مختلفين، ابعت الـsecrets من خلال ملف JSON الخاص بالشخصية. + +### تشغيل إليزا تلقائيًا + +هذا الكود لتنفيذ جميع الخطوات اللازمة لإعداد المشروع وكذلك تشغيل الروبوت مع الشخصية الافتراضية. + +```bash +sh scripts/start.sh +``` + +### لتعديل ملف الشخصية + +افتح ملف agent/src/character.ts لتعديل الشخصية الافتراضية. قم بإلغاء التعليق وعدّل عليها. + +لتحميل شخصيات مخصصة + - استخدم الأمر "pnpm start --characters="path/to/your/character.json + - يُمكنك تحميل عدة ملفات للشخصيات في نفس الوقت. + +الاتصال بـ X (تويتر): + - غيّر "clients": [] إلى "clients": ["twitter"] في ملف الشخصية للاتصال بـ X أو تويتر + +### لتشغيل إليزا يدويًا + +```bash +pnpm i +pnpm build +pnpm start + +# المشروع يتطور سريعًا. لذا قد تحتاج إلى تنظيف المشروع إذا قمت بالرجوع إليه بعد فترة. +pnpm clean +``` + +#### المتطلبات الإضافية + +قد تحتاج إلى تثبيت Sharp. إذا واجهت خطأ أثناء بدء التشغيل، جرب استخدام الأمر التالي: + +``` +pnpm install --include=optional sharp +``` + +### المجتمع والدعم + +- في حال إذا واجهت أي مشاكل تتعلق باستخدام إليزا ولتقديم المقترحات [GitHub Issues](https://github.com/elizaos/eliza/issues). +- لمشاركة تطبيقاتك والتفاعل مع المجتمع [Discord](https://discord.gg/ai16z). + +## المُساهمون + + + + + +## تاريخ النجوم + +[![Star History Chart](https://api.star-history.com/svg?repos=elizaos/eliza&type=Date)](https://star-history.com/#elizaos/eliza&Date) diff --git a/README_DE.md b/README_DE.md new file mode 100644 index 0000000000..c1bf8b4b25 --- /dev/null +++ b/README_DE.md @@ -0,0 +1,128 @@ +# Eliza 🤖 + +
+ Eliza Banner +
+ +
+ +📖 [Dokumentation](https://elizaos.github.io/eliza/) | 🎯 [Beispiele](https://github.com/thejoven/awesome-eliza) + +
+ +## ✨ Funktionen + +- 🛠️ Voll ausgestattete Konnektoren für Discord, Twitter und Telegram +- 👥 Multi-Agenten- und Raumunterstützung +- 📚 Einfache Verarbeitung und Interaktion mit deinen Dokumenten +- 💾 Abrufbarer Speicher und Dokumentenspeicher +- 🚀 Hochgradig erweiterbar – erstelle deine eigenen Aktionen und Clients +- ☁️ Unterstützt viele Modelle (lokales Llama, OpenAI, Anthropic, Groq usw.) +- 📦 Einfach funktionsfähig! + +## 🎯 Anwendungsfälle + +- 🤖 Chatbots +- 🕵️ Autonome Agenten +- 📈 Geschäftsprozessmanagement +- 🎮 NPCs in Videospielen +- 🧠 Handel + +## 🚀 Schnelleinstieg + +### Voraussetzungen + +- [Python 2.7+](https://www.python.org/downloads/) +- [Node.js 23+](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) +- [pnpm](https://pnpm.io/installation) + +> **Hinweis für Windows-Benutzer:** [WSL 2](https://learn.microsoft.com/de-de/windows/wsl/install-manual) ist erforderlich. + +### Nutzung des Starters (Empfohlen) + +```bash +git clone https://github.com/elizaos/eliza-starter.git + +cp .env.example .env + +pnpm i && pnpm start +``` + +Lies dann die [Dokumentation](https://elizaos.github.io/eliza/), um zu erfahren, wie du Eliza anpassen kannst. + +### Manuelles Starten von Eliza (Nur empfohlen, wenn du genau weißt, was du tust) + +```bash +# Repository klonen +git clone https://github.com/elizaos/eliza.git + +# Wechsle zur neuesten Version +# Dieses Projekt entwickelt sich schnell weiter, daher empfehlen wir, die neueste Version zu verwenden +git checkout $(git describe --tags --abbrev=0) +``` + +### Eliza mit Gitpod starten + +[![In Gitpod öffnen](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/elizaos/eliza/tree/main) + +### Bearbeite die .env-Datei + +Kopiere .env.example nach .env und fülle die entsprechenden Werte aus. + +``` +cp .env.example .env +``` + +Hinweis: .env ist optional. Wenn du vorhast, mehrere unterschiedliche Agenten auszuführen, kannst du Geheimnisse über die Charakter-JSON übergeben. + +### Eliza automatisch starten + +Dies führt alle notwendigen Schritte aus, um das Projekt einzurichten und den Bot mit dem Standardcharakter zu starten. + +```bash +sh scripts/start.sh +``` + +### Charakterdatei bearbeiten + +1. Öffne `agent/src/character.ts`, um den Standardcharakter zu bearbeiten. Kommentiere und bearbeite ihn. + +2. Um benutzerdefinierte Charaktere zu laden: + - Verwende `pnpm start --characters="path/to/your/character.json"` + - Mehrere Charakterdateien können gleichzeitig geladen werden. +3. Verbinde mit X (Twitter) + - Ändere `"clients": []` zu `"clients": ["twitter"]` in der Charakterdatei, um eine Verbindung mit X herzustellen. + +### Eliza manuell starten + +```bash +pnpm i +pnpm build +pnpm start + +# Das Projekt entwickelt sich schnell weiter. Manchmal musst du das Projekt bereinigen, wenn du es nach einiger Zeit erneut aufrufst. +pnpm clean +``` + +#### Zusätzliche Anforderungen + +Möglicherweise musst du Sharp installieren. Wenn beim Starten ein Fehler auftritt, versuche es mit folgendem Befehl: + +``` +pnpm install --include=optional sharp +``` + +### Community & Kontakt + +- [GitHub Issues](https://github.com/elizaos/eliza/issues). Am besten geeignet für: Bugs, die du bei der Nutzung von Eliza findest, und Feature-Vorschläge. +- [Discord](https://discord.gg/ai16z). Am besten geeignet für: das Teilen deiner Anwendungen und den Austausch mit der Community. + +## Contributors + + + + + +## Star History + +[![Star History Chart](https://api.star-history.com/svg?repos=elizaos/eliza&type=Date)](https://star-history.com/#elizaos/eliza&Date) diff --git a/README_ES.md b/README_ES.md new file mode 100644 index 0000000000..17156e094c --- /dev/null +++ b/README_ES.md @@ -0,0 +1,181 @@ +# Eliza + +Banner de Eliza + +## Funcionalidades + +- 🛠 Conectores completos para Discord, Twitter y Telegram +- 👥 Soporte para múltiples agentes y salas +- 📚 Ingestión e interacción sencilla con documentos +- 💾 Memoria recuperable y almacenamiento de documentos +- 🚀 Altamente extensible - cree sus propias acciones y clientes para expandir capacidades +- ☁️ Soporta múltiples modelos, incluidos Llama local, OpenAI, Anthropic, Groq y más +- 📦 Funciona perfectamente + +## Usos + +- 🤖 Chatbots +- 🕵️ Agentes autónomos +- 📈 Gestión de procesos empresariales +- 🎮 NPCs en videojuegos + +# Primeros Pasos + +**Requisitos (OBLIGATORIOS):** + +- [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 el archivo .env + +- Copie el archivo .env.example a .env y complete los valores apropiados +- Edite las variables de entorno de TWITTER para agregar nombre de usuario y contraseña del bot + +### Edite el archivo de personaje + +- Revise el archivo `src/core/defaultCharacter.ts` - puede modificarlo +- También puede cargar personajes con el comando `pnpm start --characters="path/to/your/character.json"` y ejecutar múltiples bots simultáneamente. + +Después de configurar el archivo .env y el archivo de personaje, puede iniciar el bot con: + +``` +pnpm i +pnpm start +``` + +# Personalizando a Eliza + +### Agregando acciones personalizadas + +Para evitar conflictos en el directorio central, se recomienda agregar acciones personalizadas a un directorio `custom_actions` y luego agregarlas al archivo `elizaConfig.yaml`. Consulte el archivo `elizaConfig.example.yaml` para un ejemplo. + +## Ejecución con Diferentes Modelos + +### Ejecutar con Llama + +Puede ejecutar modelos Llama 70B o 405B configurando la variable de ambiente `XAI_MODEL` en `meta-llama/Meta-Llama-3.1-70B-Instruct-Turbo` o `meta-llama/Meta-Llama-3.1-405B-Instruct` + +### Ejecutar con Grok + +Puede ejecutar modelos Grok configurando la variable de ambiente `XAI_MODEL` en `grok-beta` + +### Ejecutar con OpenAI + +Puede ejecutar modelos OpenAI configurando la variable de ambiente `XAI_MODEL` en `gpt-4o-mini` o `gpt-4o` + +## Requisitos Adicionales + +Puede ser necesario instalar Sharp. Si encuentra un error al iniciar, intente instalarlo con: + +``` +pnpm install --include=optional sharp +``` + +# Configuración del Entorno + +Deberá agregar variables de ambiente a su archivo .env para conectarse a varias plataformas: + +``` +# Variables de ambiente obligatorias +DISCORD_APPLICATION_ID= +DISCORD_API_TOKEN= # Token del bot +OPENAI_API_KEY=sk-* # Clave API de OpenAI, comenzando con sk- +ELEVENLABS_XI_API_KEY= # Clave API de ElevenLabs +GOOGLE_GENERATIVE_AI_API_KEY= # Clave API de Gemini + +# CONFIGURACIONES DE 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= # Nombre de usuario de la cuenta +TWITTER_PASSWORD= # Contraseña de la cuenta +TWITTER_EMAIL= # Correo electrónico de la cuenta + +X_SERVER_URL= +XAI_API_KEY= +XAI_MODEL= + +# Para consultar a 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= +``` + +# Configuración de Inferencia Local + +### Configuración CUDA + +Si tiene una GPU NVIDIA, puede instalar CUDA para acelerar significativamente la inferencia local. + +``` +pnpm install +npx --no node-llama-cpp source download --gpu cuda +``` + +Asegúrese de tener instalado el CUDA Toolkit, incluyendo cuDNN y cuBLAS. + +### Ejecución local + +Agregue XAI_MODEL y configúrelo con una de las opciones de [Ejecutar con Llama](#ejecutar-con-llama) - puede dejar X_SERVER_URL y XAI_API_KEY en blanco, descargará el modelo de HuggingFace y realizará consultas localmente + +# Clientes + +## Bot de Discord + +Para ayuda con la configuración de su Bot de Discord, consulte: https://discordjs.guide/preparations/setting-up-a-bot-application.html + +# Desarrollo + +## Pruebas + +Para ejecutar la suite de pruebas: + +```bash +pnpm test # Ejecutar pruebas una vez +pnpm test:watch # Ejecutar pruebas en modo observación +``` + +Para pruebas específicas de base de datos: + +```bash +pnpm test:sqlite # Ejecutar pruebas con SQLite +pnpm test:sqljs # Ejecutar pruebas con SQL.js +``` + +Las pruebas están escritas con Jest y se pueden encontrar en archivos `src/**/*.test.ts`. El entorno de pruebas está configurado para: + +- Cargar variables de ambiente desde `.env.test` +- Usar un límite de 2 minutos para pruebas de larga duración +- Soportar módulos ESM +- Ejecutar pruebas en secuencia (--runInBand) + +Para crear nuevas pruebas, agregue un archivo `.test.ts` junto al código que está probando. diff --git a/README_FR.md b/README_FR.md new file mode 100644 index 0000000000..6f120c1f00 --- /dev/null +++ b/README_FR.md @@ -0,0 +1,84 @@ +# Eliza + +Eliza Banner + +## Fonctionnalités + +- 🛠 Support des connecteurs Discord/ Twitter / Telegram +- 🔗 Support des différents modèles d'IA (Llama, Grok, OpenAI, Anthropic, etc.) +- 👥 Gestion de plusieurs agents et assistance +- 📚 Import et interactions avec différents types de documents simplifiés +- 💾 Accès aux données en mémoire et aux documents stockés +- 🚀 Grande personnalisation possible : création de nouveaux clients et de nouvelles actions +- 📦 Simplicité d'utilisation + +Que pouvez-vous faire avec Eliza? + +- 🤖 Chatbot +- 🕵 Agents autonomes +- 📈 Processus automatisés +- 🎮 PNJ interactifs +- 🧠 Trading automatisé + +# Premiers pas + +**Pré-requis (obligatoire) :** + +- [Python 2.7+](https://www.python.org/downloads/) +- [Node.js 23+](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) +- [pnpm](https://pnpm.io/installation) + +> **Note pour Windows :** WSL est requis + +### Editer le fichier .env + +- Copier le fichier d'exemple .env.example et le remplir avec les valeurs adéquates + +``` +cp .env.example .env +``` + +### Modifier les fichiers personnage + +1. Ouvrir le document `src/core/defaultCharacter.ts` afin de modifier le personnage par défaut + +2. Pour ajouter des personnages personnalisés : + - Lancer la commande `pnpm start --characters="path/to/your/character.json"` + - Plusieurs fichiers personnages peuvent être ajoutés en même temps + +### Lancer Eliza + +Après avoir terminé la configuration et les fichiers personnage, lancer le bot en tapant la ligne de commande suivante: + +```bash +pnpm i +pnpm build +pnpm start + +# Le projet étant régulièrement mis à jour, il vous faudra parfois le nettoyer avant de recommencer à travailler dessus +pnpm clean +``` + +#### Ressources additionnelles + +Il vous faudra peut-être installer Sharp. +S'il y a une erreur lors du lancement du bot, essayez d'installer Sharp comme ceci : + +``` +pnpm install --include=optional sharp +``` + +### Communauté et réseaux sociaux + +- [GitHub](https://github.com/elizaos/eliza/issues). Pour partager les bugs découverts lors de l'utilisation d'Eliza, et proposer de nouvelles fonctionnalités. +- [Discord](https://discord.gg/ai16z). Pour partager ses applications et rencontrer la communauté. + +## Contributeurs + + + + + +## Historique d'étoiles + +[![Star History Chart](https://api.star-history.com/svg?repos=elizaos/eliza&type=Date)](https://star-history.com/#elizaos/eliza&Date) diff --git a/README_HE.md b/README_HE.md new file mode 100644 index 0000000000..c25f8e17be --- /dev/null +++ b/README_HE.md @@ -0,0 +1,194 @@ +
+ +# אלייזה 🤖 + +
+ אלייזה באנר +
+ +
+ +📖 [תיעוד](https://elizaos.github.io/eliza/) | 🎯 [דוגמאות](https://github.com/thejoven/awesome-eliza) + +
+ +
+ +[中文说明](https://github.com/elizaos/Elisa/blob/main/README_CN.md) | [日本語の説明](https://github.com/elizaos/Elisa/blob/main/README_JA.md) | [한국어 설명](https://github.com/elizaos/Elisa/blob/main/README_KOR.md) | [Français](https://github.com/elizaos/Elisa/blob/main/README_FR.md) | [Português](https://github.com/elizaos/Elisa/blob/main/README_PTBR.md) | [Türkçe](TR.md) | [Русский](https://github.com/elizaos/Elisa/blob/main/README_RU.md) | [Español](https://github.com/elizaos/Elisa/blob/main/README_ES.md) | [Italiano](https://github.com/elizaos/Elisa/blob/main/README_IT.md) | [ไทย](https://github.com/elizaos/Elisa/blob/main/README_TH.md) | [Deutsch](https://github.com/elizaos/Elisa/blob/main/README_DE.md) | [עִברִית](https://github.com/elizaos/Elisa/blob/main/README_HE.md) + +
+ +
+ +## ✨ תכונות + +- 🛠️ מחברים מלאים לדיסקורד, טוויטר וטלגרם +- 🔗 תמיכה בכל מודל (Llama, Grok, OpenAI, Anthropic, וכו') +- 👥 תמיכה בריבוי סוכנים וחדרים +- 📚 קל לשלב ולהשתמש במסמכים שלך +- 💾 זיכרון ומאגר מסמכים הניתנים לשליפה +- 🚀 ניתן להרחבה רבה - יצירת פעולות ולקוחות משלך +- ☁️ תומך בהרבה מודלים (local Llama, OpenAI, Anthropic, Groq , + וכו') +- 📦 פשוט עובד! + +
+ +## 🎯 מקרי שימוש + +
+- 🤖 צ'טבוטים +
+
+- 🕵️ סוכנים אוטונומיים +
+
+- 📈 טיפול בתהליכים עסקיים +
+
+- 🎮 במשחקי וידאו (NPCs) +
+
+- 🧠 מסחר +
+ +## 🚀 התחלה מהירה + +
+ +### דרישות מוקדמות + +[Python 2.7+](https://www.python.org/downloads/) - + +[Node.js 23+](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) - + +[pnpm](https://pnpm.io/installation) - + +> **הערה למשתמשי Windows:** נדרש [WSL 2](https://learn.microsoft.com/en-us/windows/wsl/install-manual) + +
+ +### שימוש ב-Starter (מומלץ) + +
+ +``` +git clone https://github.com/elizaos/eliza-starter.git + +cp .env.example .env + +pnpm i && pnpm start +``` + +
+ +לאחר מכן קרא את [התיעוד](https://elizaos.github.io/eliza/) כדי ללמוד כיצד להתאים את אלייזה. + +### התחלה ידנית של אלייזה (מומלץ רק למי שיודע מה הוא עושה) + +
+ +``` +# שכפול המאגר +git clone https://github.com/elizaos/eliza.git + +# מעבר לגרסה האחרונה +git checkout $(git describe --tags --abbrev=0) +``` + +
+ +### התחלת אלייזה עם Gitpod + +
+ +[![פתח ב-Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/elizaos/eliza/tree/main) + +
+ +### עריכת קובץ .env + +
+ +העתק את .env.example ל-.env ומלא את הערכים המתאימים. + +``` +cp .env.example .env +``` + +
+ +הערה: .env הוא אופציונלי. אם אתם מתכננים להפעיל מספר סוכנים נפרדים, ניתן להעביר סודות דרך JSON הדמות. + +### התחלה אוטומטית של אלייזה + +פעולה זו תפעיל הכל כדי להגדיר את הפרויקט ולהתחיל את הבוט עם הדמות המובנית. + +
+ +```bash +sh scripts/start.sh +``` + +
+ +### עריכת קובץ הדמות + +1. פתח את `agent/src/character.ts` כדי לשנות את דמות ברירת המחדל. בטל הערה וערוך. + +2. לטעינת דמויות מותאמות אישית: + + - השתמש ב-`pnpm start --characters="path/to/your/character.json"` + - ניתן לטעון מספר קבצי דמויות בו זמנית. + +3. התחבר עם X (טוויטר): + - שנה `"clients": []` ל-`"clients": ["twitter"]` בקובץ הדמות כדי להתחבר ל-X. + +### התחלה ידנית של אלייזה + +
+ +```bash +pnpm i +pnpm build +pnpm start + +# לעיתים צריך לנקות את הפרויקט אם חוזרים אליו לאחר זמן +pnpm clean +``` + +
+ +#### דרישות נוספות + +ייתכן שתצטרך להתקין את Sharp. אם אתה רואה שגיאה בעת ההפעלה, נסה להתקין עם הפקודה הבאה: + +``` +pnpm install --include=optional sharp +``` + +### קהילה ויצירת קשר + +
+ +[GitHub Issues](https://github.com/elizaos/eliza/issues) מתאים ביותר עבור: באגים ופרופוזיציות לתכונות - + +[Discord](https://discord.gg/ai16z) מתאים ביותר עבור: שיתוף היישומים שלך והשתתפות בקהילה - + +
+ +## תורמים + + + + + + + + + +## היסטוריית כוכבים + +[![תרשים היסטוריית כוכבים](https://api.star-history.com/svg?repos=elizaos/eliza&type=Date)](https://star-history.com/#elizaos/eliza&Date) + +
diff --git a/README_HU.md b/README_HU.md new file mode 100644 index 0000000000..a4f73f2d72 --- /dev/null +++ b/README_HU.md @@ -0,0 +1,133 @@ +# Eliza 🤖 + +
+ Eliza Banner +
+ +
+ +📖 [Dokumentáció](https://elizaos.github.io/eliza/) | 🎯 [Példák](https://github.com/thejoven/awesome-eliza) + +
+ +## ✨ Funkciók + +- 🛠️ Teljes funkcionalitású Discord, Twitter és Telegram összekötők +- 🔗 Támogatás minden modellhez (Llama, Grok, OpenAI, Anthropic, etc.) +- 👥 Többügynök és szobatámogatás +- 📚 Könnyen feldolgozhatja és kezelheti dokumentumait +- 💾 Helyrehozható memória és dokumentumtár +- 🚀 Magas fokú bővíthetőség - hozz létre saját műveleteket és klienseket +- ☁️ Számos modell támogatása (helyi Llama, OpenAI, Anthropic, Groq stb.) +- 📦 Egyszerűen működik! + +## 🎯 Felhasználási területek + +- 🤖 Chatbotok +- 🕵️ Autonóm ügynökök +- 📈 Üzleti folyamatkezelés +- 🎮 Videójáték NPC-k +- 🧠 Kereskedés + +## 🚀 Gyors kezdés + +### Előfeltételek + +- [Python 2.7+](https://www.python.org/downloads/) +- [Node.js 23+](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) +- [pnpm](https://pnpm.io/installation) + +> **Megjegyzés Windows-felhasználóknak:** [WSL 2](https://learn.microsoft.com/en-us/windows/wsl/install-manual) szükséges. + +### Használja az Indítót (Ajánlott) + +```bash +git clone https://github.com/elizaos/eliza-starter.git +cd eliza-starter +cp .env.example .env +pnpm i && pnpm build && pnpm start +``` +Miután az ügynök elindult, a folyamat végén egy üzenetet kell látnod, amely arra utal, hogy futtasd a "pnpm start:client" parancsot. +Nyiss egy másik terminált, navigálj ugyanabba a könyvtárba, és futtasd az alábbi parancsot, majd kövesd az URL-t, hogy kommunikálhass az ügynököddel: +```bash +pnpm start:client +``` + +Ezután olvasd el a [Dokumentációt](https://elizaos.github.io/eliza/) hogy megtanuld, hogyan testreszabhatod Elizát. + +### Eliza manuális indítása (Csak akkor ajánlott, ha pontosan tudod, mit csinálsz) + +```bash +# Klónozd a repót +git clone https://github.com/elizaos/eliza.git + +# Válts a legfrissebb kiadásra +# A projekt gyorsan fejlődik, ezért ajánlott a legfrissebb kiadásra váltani +git checkout $(git describe --tags --abbrev=0) +``` + +### Eliza indítása Gitpoddal + +[![Megnyitás Gitpodban](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/elizaos/eliza/tree/main) + +### Szerkezd a .env fájlt + +Másold a .env.example fájlt .env néven, és töltsd ki a megfelelő értékekkel. + +``` +cp .env.example .env +``` + +Megjegyzés: A .env fájl opcionális. Ha több különálló ügynököt szeretnél futtatni, a titkos adatokat a karakter JSON-on keresztül is megadhatod. + +### Eliza automatikus indítása + +Ez a parancs mindent beállít a projekthez, és elindítja a botot az alapértelmezett karakterrel. + +```bash +sh scripts/start.sh +``` + +### Karakterfájl szerkesztése +`` +1. Nyisd meg a `packages/core/src/defaultCharacter.ts` fájlt, hogy módosítsd az alapértelmezett karaktert. Kommentezd ki és szerkeszd. + +2. Egyedi karakterek betöltése: + - Használhatod a következőt: `pnpm start --characters="path/to/your/character.json"` + - Több karakterfájl is betölthető egyszerre. +3. Kapcsolódás X-hez (Twitter) + - Módosítsd a `"clients": []` részt `"clients": ["twitter"]` -re a karakterfájlban, hogy csatlakozz az X-hez + +### Eliza manuális indítása + +```bash +pnpm i +pnpm build +pnpm start + +# A projekt gyorsan fejlődik. Néha meg kell tisztítania a projektet, amikor egy idő után újra visszatérsz. +pnpm clean +``` + +#### További követelmények + +Előfordulhat, hogy telepítened kell a Sharpot. Ha hibát látsz az indításkor, próbáld meg telepíteni az alábbi paranccsal: + +``` +pnpm install --include=optional sharp +``` + +### Közösség és kapcsolattartás + +- [GitHub Issues](https://github.com/elizaos/eliza/issues). Ideális hibák jelentésére és új funkciók javaslatára. +- [Discord](https://discord.gg/ai16z). BTökéletes hely az alkalmazásaid megosztására és a közösséggel való kapcsolatépítésre. + +## Közreműködők + + + + + +## Star History + +[![Star History Chart](https://api.star-history.com/svg?repos=elizaos/eliza&type=Date)](https://star-history.com/#elizaos/eliza&Date) diff --git a/README_IT.md b/README_IT.md new file mode 100644 index 0000000000..06bd7365fb --- /dev/null +++ b/README_IT.md @@ -0,0 +1,92 @@ +# Eliza 🤖 + +
+ Eliza Banner +
+ +## ✨ Caratteristiche + +- 🛠️ Connettori completi per Discord, Twitter e Telegram +- 🔗 Supporto per tutti i modelli (Llama, Grok, OpenAI, Anthropic, ecc.) +- 👥 Supporto multi-agente e per stanze +- 📚 Acquisisci e interagisci facilmente con i tuoi documenti +- 💾 Memoria recuperabile e archivio documenti +- 🚀 Altamente estensibile - crea le tue azioni e clients personalizzati +- ☁️ Supporto di numerosi modelli (Llama locale, OpenAI, Anthropic, Groq, ecc.) +- 📦 Funziona e basta! + +## 🎯 Casi d'uso + +- 🤖 Chatbot +- 🕵️ Agenti Autonomi +- 📈 Gestione dei processi aziendali +- 🎮 NPC per Videogiochi +- 🧠 Trading + +## 🚀 Avvio Rapido + +### Prerequisiti + +- [Python 2.7+](https://www.python.org/downloads/) +- [Node.js 23+](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) +- [pnpm](https://pnpm.io/installation) + +> **Nota per gli utenti Windows:** È richiesto WSL + +### Modifica il file .env + +Copia .env.example in .env e inserisci i valori appropriati + +``` +cp .env.example .env +``` + +### Avvia Eliza Automaticamente + +Questo script eseguirà tutti i comandi necessari per configurare il progetto e avviare il bot con il personaggio predefinito. + +```bash +sh scripts/start.sh +``` + +### Modifica il file del personaggio + +1. Apri `packages/agent/src/character.ts` per modificare il personaggio predefinito. Decommenta e modifica. + +2. Per caricare personaggi personalizzati: + - Usa `pnpm start --characters="percorso/del/tuo/personaggio.json"` + - È possibile caricare più file di personaggi contemporaneamente + +### Avvia Eliza Manualmente + +```bash +pnpm i +pnpm build +pnpm start + +# Il progetto evolve rapidamente; a volte è necessario pulire il progetto se si ritorna sul progetto dopo un po' di tempo +pnpm clean +``` + +#### Requisiti Aggiuntivi + +Potrebbe essere necessario installare Sharp. Se vedi un errore all'avvio, prova a installarlo con il seguente comando: + +``` +pnpm install --include=optional sharp +``` + +### Comunità e contatti + +- [GitHub Issues](https://github.com/elizaos/eliza/issues). Ideale per segnalare bug riscontrati durante l’utilizzo di Eliza e proporre nuove funzionalità. +- [Discord](https://discord.gg/ai16z). Ideale per condividere le tue applicazioni e interagire con la comunità. + +## Contributori + + + + + +## Cronologia Stelle + +[![Grafico Cronologia Stelle](https://api.star-history.com/svg?repos=elizaos/eliza&type=Date)](https://star-history.com/#elizaos/eliza&Date) diff --git a/README_JA.md b/README_JA.md new file mode 100644 index 0000000000..dea9a32e27 --- /dev/null +++ b/README_JA.md @@ -0,0 +1,181 @@ +# Eliza + +Eliza Banner + +## 機能 + +- 🛠 Discord、Twitter、Telegramのフル機能コネクタ +- 👥 マルチエージェントおよびルームサポート +- 📚 ドキュメントの簡単な取り込みと対話 +- 💾 検索可能なメモリおよびドキュメントストア +- 🚀 高い拡張性 - 機能を拡張するための独自のアクションとクライアントを作成可能 +- ☁️ Llama、OpenAI、Anthropic、Groqなど、多くのモデルをサポート +- 📦 すぐに使える! + +## 何に使えるのか? + +- 🤖 チャットボット +- 🕵️ 自律エージェント +- 📈 ビジネスプロセスの処理 +- 🎮 ビデオゲームのNPC + +# 始め方 + +**必須条件:** + +- [Node.js 23+](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) +- [pnpm](https://pnpm.io/installation) + +### .envファイルの編集 + +- .env.exampleを.envにコピーし、適切な値を入力 +- TWITTER環境変数を編集して、ボットのユーザー名とパスワードを追加 + +### キャラクターファイルの編集 + +- `src/core/defaultCharacter.ts`ファイルを確認 - これを変更可能 +- `pnpm start --characters="path/to/your/character.json"`を使用してキャラクターをロードし、複数のボットを同時に実行可能 + +.envファイルとキャラクターファイルを設定した後、以下のコマンドでボットを起動可能: + +``` +pnpm i +pnpm start +``` + +# Elizaのカスタマイズ + +### カスタムアクションの追加 + +コアディレクトリでのGitの競合を避けるために、カスタムアクションを`custom_actions`ディレクトリに追加し、それを`elizaConfig.yaml`ファイルに追加することをお勧めします。例については`elizaConfig.example.yaml`ファイルを参照してください。 + +## 異なるモデルでの実行 + +### Llamaでの実行 + +`XAI_MODEL`環境変数を`meta-llama/Meta-Llama-3.1-70B-Instruct-Turbo`または`meta-llama/Meta-Llama-3.1-405B-Instruct`に設定することで、Llama 70Bまたは405Bモデルを実行可能 + +### Grokでの実行 + +`XAI_MODEL`環境変数を`grok-beta`に設定することで、Grokモデルを実行可能 + +### OpenAIでの実行 + +`XAI_MODEL`環境変数を`gpt-4o-mini`または`gpt-4o`に設定することで、OpenAIモデルを実行可能 + +## 追加の要件 + +Sharpをインストールする必要があるかもしれません。起動時にエラーが表示された場合は、以下のコマンドでインストールを試みてください: + +``` +pnpm install --include=optional sharp +``` + +# 環境設定 + +���まざまなプラットフォームに接続するために、.envファイルに環境変数を追加する必要があります: + +``` +# 必須環境変数 +DISCORD_APPLICATION_ID= +DISCORD_API_TOKEN= # ボットトークン +OPENAI_API_KEY=sk-* # OpenAI APIキー、sk-で始まる +ELEVENLABS_XI_API_KEY= # elevenlabsからのAPIキー + +# 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= # アカウントのユーザー名 +TWITTER_PASSWORD= # アカウントのパスワード +TWITTER_EMAIL= # アカウントのメール + +X_SERVER_URL= +XAI_API_KEY= +XAI_MODEL= + + +# 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= +``` + +# ローカル推論設定 + +### CUDA設定 + +NVIDIA GPUを持っている場合、CUDAをインストールしてローカル推論を大幅に高速化可能 + +``` +pnpm install +npx --no node-llama-cpp source download --gpu cuda +``` + +CUDA Toolkit、cuDNN、cuBLASをインストールしていることを確認してください。 + +### ローカルでの実行 + +XAI_MODELを追加し、[Llamaでの実行](#run-with-llama)のオプションのいずれかに設定 - X_SERVER_URLとXAI_API_KEYを空白のままにしておくと、huggingfaceからモデルをダウンロードし、ローカルでクエリを実行します。 + +# クライアント + +## Discordボット + +Discordボットの設定に関するヘルプについては、こちらを参照してください: https://discordjs.guide/preparations/setting-up-a-bot-application.html + +# 開発 + +## テスト + +テストスイートを実行するには: + +```bash +pnpm test # テストを一度実行 +pnpm test:watch # ウォッチモードでテストを実行 +``` + +データベース固有のテストの場合: + +```bash +pnpm test:sqlite # SQLiteでテストを実行 +pnpm test:sqljs # SQL.jsでテストを実行 +``` + +テストはJestを使用して記述されており、`src/**/*.test.ts`ファイルにあります。テスト環境は次のように構成されています: + +- `.env.test`から環境変数をロード +- 長時間実行されるテストのために2分のタイムアウトを使用 +- ESMモジュールをサポート +- テストを順番に実行 (--runInBand) + +新しいテストを作成するには、テストするコードの隣に`.test.ts`ファイルを追加します。 diff --git a/README_KOR.md b/README_KOR.md new file mode 100644 index 0000000000..6e643e67d0 --- /dev/null +++ b/README_KOR.md @@ -0,0 +1,129 @@ +# Eliza 🤖 + +
+ Eliza Banner +
+ +
+ +📖 [문서](https://elizaos.github.io/eliza/) | 🎯 [예시](https://github.com/thejoven/awesome-eliza) + +
+ +## ✨ 기능 + +- 🛠 SNS 지원: 디스코드, 트위터, 텔레그램 연동 지원 +- 🔗 다양한 모델 지원 (Llama, Grok, OpenAI, Anthropic 등) +- 👥 다중 지원: 다중 에이전트 및 채팅방 지원 +- 📚 높은 유연성: 데이터를 쉽게 추가하고 다양한 상호작용 가능 +- 💾 검색 지원: 데이터와 작업을 쉽게 찾아볼 수 있도록 검색 기능 지원 +- 🚀 높은 확장성: 사용자 정의 동작 및 클라이언트 생성 가능 +- ☁️ 다양한 AI 모델 지원: local Llama, OpenAI, Anthropic, Groq 등 다양한 AI 모델을 지원합니다 +- 📦 즐겁게 개발해 봐요! + +## 🎯 사용 사례 + +- 🤖 챗봇 +- 🕵 ️자율 에이전트 +- 📈 자동화 프로세스 +- 🎮 비디오 게임 NPC +- 🧠 트레이딩 + +## 🚀 빠른 시작 + +### 필수 요구사항: + +- [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) + +> **Windows 사용자 참고:** [WSL 2](https://learn.microsoft.com/en-us/windows/wsl/install-manual) 필요. + +### Starter 사용 (권장) + +```bash +git clone https://github.com/elizaos/eliza-starter.git + +cp .env.example .env + +pnpm i && pnpm start +``` + +[문서](https://elizaos.github.io/eliza/)를 참고하여 Eliza를 커스마이징 방법을 확인하세요. + +### 수동으로 실행 (사용법을 알고 있는 경우에만 권장) + +```bash +# 저장소 복사 +git clone https://github.com/elizaos/eliza.git + +# 최신 릴리스로 체크아웃 +# 프로젝트가 빠르게 수정되므로 최신 릴리스를 체크아웃하는 것을 권장합니다. +git checkout $(git describe --tags --abbrev=0) +``` + +### Gitpod로 Eliza 시작 + +[![Gitpod로 열기](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/elizaos/eliza/tree/main) + +### .env 파일 편집 + +.env.example을 복사해서 필요한 값들을 채워넣어 .env파일을 만드세요. + +``` +cp .env.example .env +``` + +참고: .env는 선택 사항입니다. 여러 개의 에이전트를 실행하려는 경우, 캐릭터 JSON 파일을 통해 비밀 변수를 전달할 수 있습니다. + +### Eliza 자동 시작 + +아래 명령은 프로젝트를 설정하고 기본 캐릭터와 함께 봇을 시작합니다. + +```bash +sh scripts/start.sh +``` + +### character file 편집 + +1. `agent/src/character.ts`를 열어 기본 캐릭터를 수정하세요. 주석을 해제하고 수정하시면 됩니다. + +2. 커스텀 캐릭터 로드하기: + - `pnpm start --characters="path/to/your/character.json"`을 사용합니다. + - 여러 캐릭터 파일을 동시에 로드할 수 있습니다. +3. X (Twitter) 연결: + - 캐릭터 파일에서 `"clients": []`를 `"clients": ["twitter"]`로 변경합니다. + +### Eliza 수동 시작 + +```bash +pnpm i +pnpm build +pnpm start + +# 프로젝트가 빠르게 수정되므로 프로젝트를 clean해야 할 수도 있습니다. +pnpm clean +``` + +#### 추가 요구 사항 + +시작 시 에러가 발생하면 Sharp를 설치해야 할 수 있습니다. 아래 명령어를 사용하여 설치하세요: + +``` +pnpm install --include=optional sharp +``` + +### 커뮤니티 & 문의 + +- [Github Issues](https://github.com/elizaos/eliza/issues). 용도: Eliza 사용 중 발견된 버그 리포트, 기능 제안. +- [Discord](https://discord.gg/ai16z). 용도: 애플리케이션 공유 및 커뮤니티 활동. + +## 기여자 + + + + + +## 스타 기록 + +[![Star History Chart](https://api.star-history.com/svg?repos=elizaos/eliza&type=Date)](https://star-history.com/#elizaos/eliza&Date) \ No newline at end of file diff --git a/README_PL.md b/README_PL.md new file mode 100644 index 0000000000..5c927e4dc9 --- /dev/null +++ b/README_PL.md @@ -0,0 +1,137 @@ +# Eliza 🤖 + +
+ Eliza Banner +
+ +
+ +📖 [Dokumentacja](https://elizaos.github.io/eliza/) | 🎯 [Przykłady](https://github.com/thejoven/awesome-eliza) + +
+ +## ✨ Cechy modelu: + +- 🛠️ Pełne wsparcie dla Discorda, Telegrama i Twittera +- 🔗 Wsparcie dla wszystkich modeli AI (Llama, Grok, OpenAI, Anthropic, itd.) +- 👥 Wiele osobowości jednocześnie oraz wsparcie dla pokoi +- 📚 Prosta konstrukcja i łatwość modyfikacji ustawień +- 💾 Przywracalna pamięć i opcja przechowywania dokumentów +- 🚀 Wiele możliwości rozszerzeń - twórz własne klienty, aplikacje itd +- ☁️ Wsparcie dla szerokiej gamy modeli (local Llama, OpenAI, Anthropic, Groq, etc.) +- 📦 To po prostu działa! + +## Poradniki wideo + +[AI Agent Dev School](https://www.youtube.com/watch?v=ArptLpQiKfI&list=PLx5pnFXdPTRzWla0RaOxALTSTnVq53fKL) + +## 🎯 Przykłady zastosowania + +- 🤖 Chatboty +- 🕵️ Autonomiczni Agenci +- 📈 Utrzymanie procesów biznesowych +- 🎮 Zaplecze dla postaci NPC w grach +- 🧠 Handel + +## 🚀 Jak zacząć? + +### Wstępne wymagania: + +- [Python 2.7+](https://www.python.org/downloads/) +- [Node.js 23+](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) +- [pnpm](https://pnpm.io/installation) + +> **Notka dla użytkowników Windowsa:** [WSL 2](https://learn.microsoft.com/en-us/windows/wsl/install-manual) jest wymagane!. + +### Użycie startera (Rekomendowane) + +```bash +git clone https://github.com/elizaos/eliza-starter.git +cd eliza-starter +cp .env.example .env +pnpm i && pnpm build && pnpm start +``` +Gdy agent się uruchomi, powinien pojawić się komunikat aby uruchomić komendę "pnpm start:client". +Wtedy trzeba odpalić drugi terminal, przejść do tego samego folderu, w którym mamy sklonowany kod z Githuba i odpalić tą komendę, aby być w stanie rozpocząć konwersację z naszym botem. +```bash +pnpm start:client +``` + +Następnie zapoznaj się z [Dokumentacją](https://elizaos.github.io/eliza/). Tam jest szcegółowo opisane, jak modyfikować i dopasować Elizę do własnych potrzeb. + +### Manualny start (Przeznaczone dla osób, które wiedzą, co robią) + +```bash +# Sklonuj repozytorium +git clone https://github.com/elizaos/eliza.git + +# Sprawdź, czy na pewno masz najnowszą wersję +# Projekt rozrasta się bardzo szybko, dlatego zalecane jest aby często sprawdzać wersję +git checkout $(git describe --tags --abbrev=0) +``` + +### Start przy użyciu Gitpod'a + +[![Otwórz w Gitpodzie](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/elizaos/eliza/tree/main) + +### Edytuj plik .env + +Zmień nazwę pliku .env.example na .env i wypełnij wartości zmiennych, które będą potrzebne do uruchomienia aplikacji. + +``` +cp .env.example .env +``` + +Uwaga: .env jest opcjonalne. Jeżeli planujesz stawiać więcej niż jedną postać, zalecane jest korzystanie z plików JSON dedykowanych dla charakterów. Będzie to bardziej przejrzyste i łatwiejsze do znalezienia gdy trzeba będzie wprowadzić jakieś zmiany. + +### Automatyczny start Elizy + +Ta komenda postawi projekt i uruchomi bota z domyślnym charakterem. + +```bash +sh scripts/start.sh +``` + +### Edycja pliku postaci + +1. Otwórz `packages/core/src/defaultCharacter.ts` aby zmodyfikować postać. Odkomentuj i edytuj. + +2. Aby załadować niestandardowe osobowości: + - Uzyj komendy `pnpm start --characters="path/to/your/character.json"` + - Wiele plików z osobowościami może być załadowana jednocześnie +3. Połącz z platformą X (niegdyś Twitter) + - zamień `"clients": []` na `"clients": ["twitter"]` w pliku osobowości aby połączyć z X + +### Manualny Start Elizy + +```bash +pnpm i +pnpm build +pnpm start + +# Projekt rozwija się bardzo szybko, dlatego jeżeli robisz sobie przerwę na jakiś czas i wejdzie w międzyczasie dużo zmian, dobrze jest użyć tej komendy: +pnpm clean +``` + +#### Dodatkowe wymagania + +Możesz musieć zainstalować pakiet Sharp. Jeżeli przy odpalaniu projektu wyskakuje błąd, spróbuj go zainstalować tą komendą: + +``` +pnpm install --include=optional sharp +``` + +### Społeczność i kontakt + +- [GitHub Issues](https://github.com/elizaos/eliza/issues). Korzystaj w przypadku gdy napotkasz na jakieś bugi podczas uzywania Elizy, lub masz jakieś propozycje rozwoju. +- [Discord](https://discord.gg/ai16z). Używaj, gdy chcesz się pochwalić swoją aplikacją lub po prostu pogadać z kimś. + +## Osoby zaangażowane w rozwój: + + + + + +## Historia gwiazdek + +[![Wykres historii gwiazdek](https://api.star-history.com/svg?repos=elizaos/eliza&type=Date)](https://star-history.com/#elizaos/eliza&Date) diff --git a/README_PTBR.md b/README_PTBR.md new file mode 100644 index 0000000000..e81258ff3a --- /dev/null +++ b/README_PTBR.md @@ -0,0 +1,183 @@ +# Eliza + +Eliza Banner + +## Funcionalidades + +- 🛠 Conectores completos para Discord, Twitter e Telegram +- 👥 Suporte a múltiplos agentes e salas +- 📚 Ingestão e interação fácil com seus documentos +- 💾 Memória recuperável e armazenamento de documentos +- 🚀 Altamente extensível - crie suas próprias ações e clientes para estender as capacidades +- ☁️ Suporta muitos modelos, incluindo Llama local, OpenAI, Anthropic, Groq e mais +- 📦 Funciona perfeitamente! + +## Para que posso usá-lo? + +- 🤖 Chatbots +- 🕵️ Agentes autônomos +- 📈 Gestão de processos empresariais +- 🎮 NPCs em jogos de vídeo + +# Começando + +**Pré-requisitos (OBRIGATÓRIO):** + +- [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 o arquivo .env + +- Copie .env.example para .env e preencha os valores apropriados +- Edite as variáveis de ambiente do TWITTER para adicionar o nome de usuário e senha do seu bot + +### Edite o arquivo de personagem + +- Confira o arquivo `src/core/defaultCharacter.ts` - você pode modificá-lo +- Você também pode carregar personagens com o comando `pnpm start --characters="path/to/your/character.json"` e executar múltiplos bots ao mesmo tempo. + +Após configurar o arquivo .env e o arquivo de personagem, você pode iniciar o bot com o seguinte comando: + +``` +pnpm i +pnpm start +``` + +# Personalizando Eliza + +### Adicionando ações personalizadas + +Para evitar conflitos no diretório core, recomendamos adicionar ações personalizadas a um diretório `custom_actions` e depois adicioná-las ao arquivo `elizaConfig.yaml`. Veja o arquivo `elizaConfig.example.yaml` para um exemplo. + +## Executando com diferentes modelos + +### Executar com Llama + +Você pode executar modelos Llama 70B ou 405B configurando a variável de ambiente `XAI_MODEL` para `meta-llama/Meta-Llama-3.1-70B-Instruct-Turbo` ou `meta-llama/Meta-Llama-3.1-405B-Instruct` + +### Executar com Grok + +Você pode executar modelos Grok configurando a variável de ambiente `XAI_MODEL` para `grok-beta` + +### Executar com OpenAI + +Você pode executar modelos OpenAI configurando a variável de ambiente `XAI_MODEL` para `gpt-4o-mini` ou `gpt-4o` + +## Requisitos Adicionais + +Pode ser necessário instalar o Sharp. Se você encontrar um erro ao iniciar, tente instalá-lo com o seguinte comando: + +``` +pnpm install --include=optional sharp +``` + +# Configuração do Ambiente + +Você precisará adicionar variáveis de ambiente ao seu arquivo .env para se conectar a várias plataformas: + +``` +# 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= +``` + +# Configuração de Inferência Local + +### Configuração CUDA + +Se você tiver uma GPU NVIDIA, pode instalar o CUDA para acelerar dramaticamente a inferência local. + +``` +pnpm install +npx --no node-llama-cpp source download --gpu cuda +``` + +Certifique-se de ter instalado o CUDA Toolkit, incluindo cuDNN e cuBLAS. + +### Executando localmente + +Adicione XAI_MODEL e configure-o para uma das opções acima de [Executar com Llama](#executar-com-llama) - você pode deixar X_SERVER_URL e XAI_API_KEY em branco, ele baixa o modelo do huggingface e faz consultas localmente + +# Clientes + +## Bot do Discord + +Para ajuda com a configuração do seu Bot do Discord, confira aqui: https://discordjs.guide/preparations/setting-up-a-bot-application.html + +# Desenvolvimento + +## Testes + +Para executar a suíte de testes: + +```bash +pnpm test # Executar testes uma vez +pnpm test:watch # Executar testes no modo watch +``` + +Para testes específicos de banco de dados: + +```bash +pnpm test:sqlite # Executar testes com SQLite +pnpm test:sqljs # Executar testes com SQL.js +``` + +Os testes são escritos usando Jest e podem ser encontrados em arquivos `src/**/*.test.ts`. O ambiente de teste está configurado para: + +- Carregar variáveis de ambiente de `.env.test` +- Usar um tempo limite de 2 minutos para testes de longa duração +- Suportar módulos ESM +- Executar testes em sequência (--runInBand) + +Para criar novos testes, adicione um arquivo `.test.ts` adjacente ao código que você está testando. diff --git a/README_RS.md b/README_RS.md new file mode 100644 index 0000000000..91164e2d10 --- /dev/null +++ b/README_RS.md @@ -0,0 +1,181 @@ +# Eliza + +Baner Eliza + +## Funkcionalnosti + +- 🛠 Kompletni konektori za Discord, Twitter i Telegram +- 👥 Podrška za više agenata i soba +- 📚 Jednostavna ingestija i interakcija sa dokumentima +- 💾 Memorija koja se može povratiti i skladištenje dokumenata +- 🚀 Visoko proširivo - kreirajte sopstvene akcije i klijente za proširenje mogućnosti +- ☁️ Podržava više modela, uključujući Llama lokalno, OpenAI, Anthropic, Groq i više +- 📦 Radi besprekorno + +## Upotrebe + +- 🤖 Chatbotovi +- 🕵️ Autonomni agenti +- 📈 Upravljanje poslovnim procesima +- 🎮 NPC-ovi u video igrama + +# Prvi Koraci + +**Zahtevi (OBAVEZNI):** + +- [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) + +### Uredite .env datoteku + +- Kopirajte datoteku .env.example u .env i popunite odgovarajuće vrednosti +- Uredite TWITTER promenljive okruženja da dodate korisničko ime i lozinku bota + +### Uredite datoteku karaktera + +- Pregledajte datoteku `src/core/defaultCharacter.ts` - možete je modifikovati +- Takođe možete učitati karaktere sa komandom `pnpm start --characters="path/to/your/character.json"` i pokrenuti više botova istovremeno. + +Nakon što konfigurišete .env datoteku i datoteku karaktera, možete pokrenuti bota sa: + +``` +pnpm i +pnpm start +``` + +# Personalizacija Elize + +### Dodavanje prilagođenih akcija + +Da biste izbegli sukobe u centralnom direktorijumu, preporučuje se dodavanje prilagođenih akcija u direktorijum `custom_actions` i zatim ih dodajte u datoteku `elizaConfig.yaml`. Pogledajte datoteku `elizaConfig.example.yaml` za primer. + +## Pokretanje sa Različitim Modelima + +### Pokretanje sa Llama + +Možete pokrenuti Llama modele 70B ili 405B podešavanjem promenljive okruženja `XAI_MODEL` na `meta-llama/Meta-Llama-3.1-70B-Instruct-Turbo` ili `meta-llama/Meta-Llama-3.1-405B-Instruct` + +### Pokretanje sa Grok + +Možete pokrenuti Grok modele podešavanjem promenljive okruženja `XAI_MODEL` na `grok-beta` + +### Pokretanje sa OpenAI + +Možete pokrenuti OpenAI modele podešavanjem promenljive okruženja `XAI_MODEL` na `gpt-4o-mini` ili `gpt-4o` + +## Dodatni Zahtevi + +Možda će biti potrebno instalirati Sharp. Ako naiđete na grešku prilikom pokretanja, pokušajte da ga instalirate sa: + +``` +pnpm install --include=optional sharp +``` + +# Konfiguracija Okruženja + +Trebaće vam da dodate promenljive okruženja u vašu .env datoteku da biste se povezali sa različitim platformama: + +``` +# Obavezne promenljive okruženja +DISCORD_APPLICATION_ID= +DISCORD_API_TOKEN= # Token bota +OPENAI_API_KEY=sk-* # API ključ OpenAI, počinje sa sk- +ELEVENLABS_XI_API_KEY= # API ključ ElevenLabs +GOOGLE_GENERATIVE_AI_API_KEY= # API ključ Gemini + +# KONFIGURACIJE 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= # Korisničko ime naloga +TWITTER_PASSWORD= # Lozinka naloga +TWITTER_EMAIL= # Email naloga + +X_SERVER_URL= +XAI_API_KEY= +XAI_MODEL= + +# Za konsultacije sa 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 + +# Konfiguracija rezervnog novčanika (zastarelo) +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= +``` + +# Konfiguracija Lokalne Inference + +### Konfiguracija CUDA + +Ako imate NVIDIA GPU, možete instalirati CUDA da značajno ubrzate lokalnu inferencu. + +``` +pnpm install +npx --no node-llama-cpp source download --gpu cuda +``` + +Uverite se da imate instaliran CUDA Toolkit, uključujući cuDNN i cuBLAS. + +### Lokalno Pokretanje + +Dodajte XAI_MODEL i konfigurišite ga sa jednom od opcija iz [Pokretanje sa Llama](#pokretanje-sa-llama) - možete ostaviti X_SERVER_URL i XAI_API_KEY praznim, preuzeće model sa HuggingFace i izvršiti upite lokalno + +# Klijenti + +## Discord Bot + +Za pomoć sa konfiguracijom vašeg Discord Bota, pogledajte: https://discordjs.guide/preparations/setting-up-a-bot-application.html + +# Razvoj + +## Testiranje + +Za pokretanje test suite-a: + +```bash +pnpm test # Pokreni testove jednom +pnpm test:watch # Pokreni testove u režimu posmatranja +``` + +Za specifične testove baze podataka: + +```bash +pnpm test:sqlite # Pokreni testove sa SQLite +pnpm test:sqljs # Pokreni testove sa SQL.js +``` + +Testovi su napisani sa Jest i mogu se naći u datotekama `src/**/*.test.ts`. Testno okruženje je konfigurisano za: + +- Učitavanje promenljivih okruženja iz `.env.test` +- Korišćenje limita od 2 minuta za dugotrajne testove +- Podršku za ESM module +- Pokretanje testova u sekvenci (--runInBand) + +Za kreiranje novih testova, dodajte `.test.ts` datoteku pored koda koji testirate. \ No newline at end of file diff --git a/README_RU.md b/README_RU.md new file mode 100644 index 0000000000..6a3ce2b0db --- /dev/null +++ b/README_RU.md @@ -0,0 +1,188 @@ +# Eliza 🤖 + +
+ Eliza Banner +
+ +
+ +📖 [Документация](https://elizaos.github.io/eliza/) | 🎯 [Примеры](https://github.com/thejoven/awesome-eliza) + +
+ +## ✨ Особенности + +- 🛠 Полноценные коннекторы для Discord, Twitter и Telegram +- 👥 Поддержка нескольких агентов и комнат +- 📚 Простое добавление и взаимодействие с вашими документами +- 💾 Запоминание контекта и хранилище документов +- 🚀 Высокая маштабируемость - создавайте свои собственные действия и клиенты для расширения возможностей +- ☁️ Поддерживает множество моделей, включая локальные Llama, OpenAI, Anthropic, Groq и другие +- 📦 Простота в работе! + +## 🎯 Для чего это можно использовать? + +- 🤖 Чат-боты +- 🕵️ Автономные агенты +- 📈 Обработка бизнес-процессов +- 🎮 NPC в видеоиграх +- 🧠 Торговля + +## 🌍 Переводы + +
+Доступные языки + +- [中文说明](./README_CN.md) +- [日本語の説明](./README_JA.md) +- [한국어 설명](./README_KOR.md) +- [Instructions en français](./README_FR.md) +- [Instruções em português](./README_PTBR.md) +- [Инструкция на русском](./README_RU.md) + +

+ +# 🚀Начало работы + +**Необходимые условия (ОБЯЗАТЕЛЬНО):** + +- [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) + > **Для Windows пользователей:** требуется WSL + +### Редактирование файла .env + +- Скопируйте `.env.example` в `.env` и заполните соответствующими значениями + +```bash +cp .env.example .env +``` + +### Редактирование файла персонажа + +1. Откройте `src/core/defaultCharacter.ts`, чтобы изменить персонажа по умолчанию. + +2. Для загрузки пользовательских персонажей: + - Используйте команду `pnpm start --characters="path/to/your/character.json"` + - Можно загружать несколько файлов персонажей одновременно. + +### Запуск Eliza + +После настройки файла `.env` и файла персонажа вы можете запустить бота с помощью следующей команды: + +```bash +pnpm i +pnpm build +pnpm start + +# Проект быстро развивается, иногда нужно очищать проект, если вы возвращаетесь к нему спустя время +pnpm clean +``` + +#### Дополнительные требования + +Возможно, потребуется установить Sharp. Если при запуске возникнет ошибка, попробуйте установить его с помощью следующей команды: + +```bash +pnpm install --include=optional sharp +``` + +# Настройка окружения + +Вам потребуется добавить переменные окружения в файл `.env` для подключения к различным платформам: + +``` +# Обязательные переменные окружения +DISCORD_APPLICATION_ID= +DISCORD_API_TOKEN= # Токен бота +OPENAI_API_KEY=sk-* # API-ключ OpenAI, начинающийся с sk- +ELEVENLABS_XI_API_KEY= # API-ключ от elevenlabs +GOOGLE_GENERATIVE_AI_API_KEY= # API-ключ Gemini + +# НАСТРОЙКИ 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= # Имя пользователя аккаунта +TWITTER_PASSWORD= # Пароль аккаунта +TWITTER_EMAIL= # Email аккаунта + +X_SERVER_URL= +XAI_API_KEY= +XAI_MODEL= + + +# Для запросов к 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= # API-ключ для BirdEye + +SOL_ADDRESS=So11111111111111111111111111111111111111112 +SLIPPAGE=1 +RPC_URL=https://api.mainnet-beta.solana.com +HELIUS_API_KEY= # API-ключ Helius + + +## Telegram +TELEGRAM_BOT_TOKEN= # Токен бота Telegram + +TOGETHER_API_KEY= + +``` + +# Локальная настройка среды + +### Настройка CUDA + +Если у вас есть NVIDIA GPU, вы можете установить CUDA для значительного ускорения локального инференса. + +```bash +pnpm install +npx --no node-llama-cpp source download --gpu cuda +``` + +Убедитесь, что вы установили CUDA Toolkit, включая cuDNN и cuBLAS. + +### Локальный запуск + +Добавьте `XAI_MODEL` и установите его в одно из вышеуказанных значений из [Запуск с Llama](#run-with-llama). Вы можете оставить `X_SERVER_URL` и `XAI_API_KEY` пустыми — модель будет загружена с huggingface и обработана локально. + +# Клиенты + +## Бот для Discord + +Для получения помощи по настройке бота Discord ознакомьтесь с инструкцией: [Настройка приложения бота](https://discordjs.guide/preparations/setting-up-a-bot-application.html). + +### Сообщество и контакты + +- [GitHub Issues](https://github.com/elizaos/eliza/issues). Лучше всего подходит для: сообщений об ошибках при использовании Eliza и предложений новых функций. +- [Discord](https://discord.gg/ai16z). Лучше всего подходит для: обмена своими приложениями и общения с сообществом. + +## Контрибьюторы + + + + + +## История звёзд + +[![График истории звёзд](https://api.star-history.com/svg?repos=elizaos/eliza&type=Date)](https://star-history.com/#elizaos/eliza&Date) diff --git a/README_TG.md b/README_TG.md new file mode 100644 index 0000000000..4263ff69ca --- /dev/null +++ b/README_TG.md @@ -0,0 +1,129 @@ + +# Eliza 🤖 + +
+ Eliza Banner +
+ +
+ +📖 [Dokumentasyon](https://elizaos.github.io/eliza/) | 🎯 [Mga Halimbawa](https://github.com/thejoven/awesome-eliza) + +
+ +## ✨ Mga Tampok + +- 🛠️ Kumpletong suporta sa [Discord](https://discord.com/), [Twitter](https://twitter.com/), at [Telegram](https://telegram.org/) +- 🔗 Suporta para sa bawat modelo (Llama, Grok, OpenAI, Anthropic, atbp.) +- 👥 Suporta para sa multi-agent at kuwarto +- 📚 Madaling mag-load at makipag-ugnayan sa iyong mga dokumento +- 💾 Naaakses na memorya at imbakan ng dokumento +- 🚀 Napakabisa - maaaring gumawa ng sarili mong mga aksyon at kliyente +- ☁️ Sinusuportahan ang maraming modelo (lokal na Llama, OpenAI, Anthropic, Groq, atbp.) +- 📦 Madaling gamitin! + +## Mga Tutorial sa Bidyo + +[AI Agent Dev School](https://www.youtube.com/watch?v=ArptLpQiKfI&list=PLx5pnFXdPTRzWla0RaOxALTSTnVq53fKL) + +## 🎯 Gamit ito para sa + +- 🤖 [Mga Chatbot](https://en.wikipedia.org/wiki/Chatbot) +- 🕵️ Mga Awtonomikong Ahente +- 📈 Pagproseso ng Negosyo +- 🎮 [Mga NPC sa mga Larong Kompyuter](https://en.wikipedia.org/wiki/Non-player_character) +- 🧠 Pangangalakal + +## 🚀 Pangkalahatang-ideya + +### Mga Kinakailangan + +- [Python 2.7+](https://www.python.org/downloads/) +- [Node.js 23+](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) +- [pnpm](https://pnpm.io/installation) + +> **Paalala para sa mga Gumagamit ng Windows:** Kailangan ang [WSL 2](https://learn.microsoft.com/en-us/windows/wsl/install-manual). + +### Gamitin ang Starter (Inirerekomenda) + +```bash +git clone https://github.com/elizaos/eliza-starter.git +cd eliza-starter +cp .env.example .env +pnpm i && pnpm build && pnpm start +``` + +Basahin ang [Dokumentasyon](https://elizaos.github.io/eliza/) upang matutunan kung paano ipasadya ang Eliza. + +### Manwal na Pag-simula ng Eliza (Inirerekomenda lamang kung alam mo ang ginagawa mo) + +```bash +# Clone the repository +git clone https://github.com/elizaos/eliza.git + +# Checkout the latest release +git checkout $(git describe --tags --abbrev=0) +``` + +### Simulan ang Eliza gamit ang Gitpod + +[![Buksan sa Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/elizaos/eliza/tree/main) + +### Ipasadya ang .env File + +Kopyahin ang `.env.example` sa `.env` at punan ang tamang mga halaga. + +```bash +cp .env.example .env +``` + +### Awtomatikong Simulan ang Eliza + +Ito ay magse-setup ng proyekto at sisimulan ang bot gamit ang kusang mapagpipilian na karakter. + +```bash +sh scripts/start.sh +``` + +### Ipasadya ang Karakter File + +1. Buksan ang `packages/core/src/defaultCharacter.ts` para baguhin ang kusang mapagpipilian na karakter. +2. Mag-load ng pasadya na mga karakter: + - Gamitin ang `pnpm start --characters="landas/sa/inyong/character.json"` + - Puwedeng mag-load ng maraming karakter file sabay-sabay. +3. Ikonekta ang Twitter (X): + - Baguhin ang `"clients": []` sa `"clients": ["twitter"]` sa karakter file upang ikonekta ang Twitter. + +### Manwal na Pag-simula ng Eliza + +```bash +pnpm i +pnpm build +pnpm start + +# Linisin ang proyekto kung bumalik ka dito matapos ang mahabang panahon +pnpm clean +``` + +#### Karagdagang Mga Kinakailangan + +Puwede mong kailangang mag-install ng [Sharp](https://sharp.pixelplumbing.com/). Kung may pagkakamali, subukang i-install ito gamit ang: + +```bash +pnpm install --include=optional sharp +``` + +### Komunidad at Kontak + +- [Mga Isyu sa GitHub](https://github.com/elizaos/eliza/issues): Para sa mga bug at mungkahi sa tampok. +- [Discord](https://discord.gg/ai16z): Para sa pagbabahagi ng aplikasyon at pakikihalubilo sa komunidad. + +## Mga Kontribyutor + + + + + +## Kasaysayan ng mga Bituin + +[![Tsart ng Kasaysayan ng mga Bituin](https://api.star-history.com/svg?repos=elizaos/eliza&type=Date)](https://star-history.com/#elizaos/eliza&Date) diff --git a/README_TH.md b/README_TH.md new file mode 100644 index 0000000000..fc853bd768 --- /dev/null +++ b/README_TH.md @@ -0,0 +1,129 @@ +# Eliza (อีไลซ่า) 🤖 + +
+ Eliza Banner +
+ +
+ +📖 [คู่มือ](https://elizaos.github.io/eliza/) | 🎯 [ตัวอย่าง](https://github.com/thejoven/awesome-eliza) + +
+ +## ✨ ฟีเจอร์ + +- 🛠️ สามารถเชื่อมต่อ Discord, Twitter และ Telegram ได้ +- 🔗 ซัพพอร์ตครบทุกโมเดล (Llama, Grok, OpenAI, Anthropic, ฯลฯ) +- 👥 มัลติเอเจนต์และห้องสนทนา +- 📚 ง่ายต่อการดึงและเข้าถึงข้อมูลเอกสาร +- 💾 มีหน่วยความจำและที่จัดเก็บข้อมูล +- 🚀 ง่ายต่อการปรับแต่งไม่ว่าจะเป็นการสร้าง clients หรือกำหนด action +- ☁️ รองรับหลายโมเดล (local Llama, OpenAI, Anthropic, Groq, ฯลฯ) +- 📦 ครบเครื่องเรื่อง AI agent! + +## 🎯 ตัวอย่างการนำไปใช้ + +- 🤖 แชทบอท +- 🕵️ เอเจนต์อิสระ (Autonomous Agent) +- 📈 จัดการฝั่งธุรกิจ +- 🎮 ตัวละครในเกมที่ไม่ใช่ผู้เล่น (NPC) +- 🧠 การเทรด + +## 🚀 เริ่มต้นการใช้งาน + +### สิ่งที่จำเป็นก่อนเริ่มใช้งาน + +- [Python 2.7+](https://www.python.org/downloads/) +- [Node.js 23+](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) +- [pnpm](https://pnpm.io/installation) + +> **หมายเหตุสำหรับผู้ใช้ Windows:** จำเป็นต้องมี [WSL 2](https://learn.microsoft.com/en-us/windows/wsl/install-manual) + +### เริ่มใช้งานด้วยตัวอย่าง (แนะนำ) + +```bash +git clone https://github.com/elizaos/eliza-starter.git + +cp .env.example .env + +pnpm i && pnpm start +``` + +จากนั้นอ่าน [คู่มือ](https://elizaos.github.io/eliza/) เพื่อศึกษาวิธีการปรับแต่ง Eliza + +### เริ่มใช้งาน Eliza ด้วยตนเอง (แนะนำสำหรับคนที่มีประสบการณ์) + +```bash +# โคลน repo +git clone https://github.com/elizaos/eliza.git + +# Checkout release ล่าสุด +# โปรเจกต์นี้มีการอัปเดตอยู่บ่อยครั้ง เราแนะนำให้ checkout release ล่าสุดเสมอ +git checkout $(git describe --tags --abbrev=0) +``` + +### เริ่มใช้งาน Eliza ผ่าน Gitpod + +[![เปิดใน Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/elizaos/eliza/tree/main) + +### แก้ไขไฟล์ .env + +คัดลอก .env.example ไปเป็น .env และระบุค่าที่เหมาะสม + +``` +cp .env.example .env +``` + +หมายเหตุ: ไม่จำเป็นต้องใช้ .env หากคุณอยากใช้งานเอเจนต์หลายๆตัวพร้อมกัน คุณสามารถส่ง secrets ผ่าน JSON ของตัวละครได้ + +### เริ่มใช้งาน Eliza แบบอัตโนมัติ + +จะทำการติดตั้งโปรเจกต์ทั้งหมด และเริ่มต้น bot ด้วยตัวละครแบบค่าเริ่มต้น + +```bash +sh scripts/start.sh +``` + +### แก้ไขไฟล์ตัวละคร + +1. เปิด `agent/src/character.ts` เพื่อแก้ไขตัวละครเริ่มต้น นำคอมเม้นออกและเริ่มแก้ไข + +2. การโหลดตัวละคร custom: + - ใช้ `pnpm start --characters="path/to/your/character.json"` + - สามารถโหลดหลายๆตัวละครพร้อมกันได้ +3. เชื่อมต่อกับ X (Twitter) + - เปลี่ยน `"clients": []` เป็น `"clients": ["twitter"]` ในไฟล์ตัวละครเพื่อเชื่อมต่อกับ X (Twitter) + +### เริ่มใช้งาน Eliza ด้วยตนเอง + +```bash +pnpm i +pnpm build +pnpm start + +# โปรเจกต์นี้มีการอัปเดตอยู่บ่อยครั้ง บางครั้งอาจต้องทำการ clean โปรเจกต์ถ้าหากกลับมาทำใหม่ +pnpm clean +``` + +#### สิ่งที่จำเป็นเพิ่มเติม + +คุณอาจต้องติดตั้ง Sharp ถ้าหากคุณเห็นข้อความ error เมื่อเริ่มต้น สามารถลองติดตั้งด้วยคำสั่งต่อไปนี้: + +``` +pnpm install --include=optional sharp +``` + +### ชุมชนและข้อมูลการติดต่อ + +- [GitHub Issues](https://github.com/elizaos/eliza/issues). เหมาะสำหรับ: เมื่อปัญหาที่พบเมื่อใช้ Eliza และข้อเสนอแนะเกี่ยวกับฟีเจอร์เพิ่มเติม +- [Discord](https://discord.gg/ai16z). เหมาะสำหรับ: แชร์ผลงานแอปพลิเคชั่นและพบปะกับคอมมูนิตี้ + +## ผู้มีส่วนร่วม + + + + + +## ประวัติดาว + +[![Star History Chart](https://api.star-history.com/svg?repos=elizaos/eliza&type=Date)](https://star-history.com/#elizaos/eliza&Date) diff --git a/README_TR.md b/README_TR.md new file mode 100644 index 0000000000..0fc3935997 --- /dev/null +++ b/README_TR.md @@ -0,0 +1,92 @@ +# Eliza 🤖 + +
+ Eliza Banner +
+ +
+ +📖 [Dokümantasyon](https://elizaos.github.io/eliza/) | 🎯 [Örnekler](https://github.com/thejoven/awesome-eliza) + +
+ +## ✨ Özellikler + +- 🛠️ Tam donanımlı Discord, Twitter ve Telegram bağlantıları +- 🔗 Tüm modeller için destek (Llama, Grok, OpenAI, Anthropic, vb.) +- 👥 Çoklu-ajan ve oda desteği +- 📚 Belgelerinizi kolayca içe aktarın ve etkileşime geçin +- 💾 Geri çağrılabilir hafıza ve belge deposu +- 🚀 Yüksek düzeyde genişletilebilir - kendi eylemlerinizi ve istemcilerinizi oluşturun +- ☁️ Birçok modeli destekler (yerel Llama, OpenAI, Anthropic, Groq, vb.) +- 📦 Hemen çalışır! + +## 🎯 Kullanım Alanları + +- 🤖 Sohbet Botları +- 🕵️ Otonom Ajanlar +- 📈 İş Süreçleri Yönetimi +- 🎮 Video Oyun NPC'leri (Oyuncu Olmayan Karakter) +- 🧠 Alım Satım + +## 🚀 Hızlı Başlangıç + +### Gereksinimler + +- [Python 2.7+](https://www.python.org/downloads/) +- [Node.js 23+](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) +- [pnpm](https://pnpm.io/installation) + +> **Windows Kullanıcıları İçin Not:** WSL gereklidir + +### .env Dosyasını Düzenleyin + +.env.example dosyasını .env olarak kopyalayın ve uygun değerleri doldurun + +``` +cp .env.example .env +``` + +### Karakter Dosyasını Düzenleyin + +1. Varsayılan karakteri değiştirmek için `src/core/defaultCharacter.ts` dosyasını açın + +2. Özel karakterleri yüklemek için: + - `pnpm start --characters="path/to/your/character.json"` komutunu kullanın + - Birden fazla karakter dosyası aynı anda yüklenebilir + +### Eliza'yı Başlatın + +.env dosyasını ve karakter dosyasını ayarladıktan sonra, botu aşağıdaki komutla başlatabilirsiniz: + +```bash +pnpm i +pnpm build +pnpm start + +# Proje hızlı gelişiyor, projeye geri döndüğünüzde bazen projeyi temizlemeniz gerekebilir +pnpm clean +``` + +#### Ek Gereksinimler + +Sharp'ı yüklemeniz gerekebilir. Başlatma sırasında bir hata görürseniz, aşağıdaki komutla yüklemeyi deneyin: + +``` +pnpm install --include=optional sharp +``` + +### Topluluk ve İletişim + +- [GitHub Issues](https://github.com/elizaos/eliza/issues). Buna uygundur: Eliza kullanırken karşılaştığınız hatalar ve özellik önerileri. +- [Discord](https://discord.gg/ai16z). Buna uygundur: Uygulamalarınızı paylaşmak ve toplulukla vakit geçirmek. + +## Katkıda Bulunanlar + + + + + +## Yıldız Geçmişi + +[![Star History Chart](https://api.star-history.com/svg?repos=elizaos/eliza&type=Date)](https://star-history.com/#elizaos/eliza&Date) diff --git a/README_VI.md b/README_VI.md new file mode 100644 index 0000000000..0622da99b7 --- /dev/null +++ b/README_VI.md @@ -0,0 +1,129 @@ +# Eliza 🤖 + +
+ Eliza Banner +
+ +
+ +📖 [Tài liệu](https://elizaos.github.io/eliza/) | 🎯 [Ví dụ](https://github.com/thejoven/awesome-eliza) + +
+ +## ✨ Tính năng + +- 🛠️ Phương thức kết nối đầy đủ tính năng với Discord, Twitter và Telegram +- 🔗 Hỗ trợ mọi mô hình ngôn ngữ lớn (Llama, Grok, OpenAI, Anthropic, v.v.) +- 👥 Hỗ trợ nhiều tác nhân và phòng trò chuyện +- 📚 Dễ dàng tiếp nhận và tương tác với tài liệu của bạn +- 💾 Bộ nhớ và kho lưu trữ tài liệu có thể truy xuất +- 🚀 Có khả năng mở rộng cao - tạo hành động và ứng dụng của riêng bạn +- ☁️ Hỗ trợ nhiều mô hình cùng lúc (Llama, OpenAI, Anthropic, Groq, v.v.) +- 📦 Đơn giản là nó hoạt động! + +## 🎯 Các trường hợp sử dụng + +- 🤖 Chatbots +- 🕵️ Các tác nhân tự động +- 📈 Xử lý các mô hình kinh tế +- 🎮 NPCs trong các trò chơi điện tử +- 🧠 Giao dịch (Trading) + +## 🚀 Bắt đầu + +### Điều kiện tiên quyết + +- [Python 2.7+](https://www.python.org/downloads/) +- [Node.js 23+](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) +- [pnpm](https://pnpm.io/installation) + +> **Chú ý cho người dùng Windows:** [WSL 2](https://learn.microsoft.com/de-de/windows/wsl/install-manual) là bắt buộc. + +### Sử dụng phiên bản Starters (Khuyến nghị) + +```bash +git clone https://github.com/elizaos/eliza-starter.git + +cp .env.example .env + +pnpm i && pnpm start +``` + +Sau đó hãy đọc [Tài liệu](https://elizaos.github.io/eliza/), để học cách để tùy chỉnh Eliza của bạn. + +### Khởi động Eliza theo cách thủ công (Chỉ khuyến khích nếu bạn biết mình đang làm gì) + +```bash +# Sao chép repository +git clone https://github.com/elizaos/eliza.git + +# Kiểm tra bản phát hành mới nhất +# Dự án này cải tiến rất nhanh, vì vậy chúng tôi khuyên bạn nên kiểm tra bản phát hành mới nhất +git checkout $(git describe --tags --abbrev=0) +``` + +### Bắt đầu Eliza với Gitpod + +[![Mở Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/elizaos/eliza/tree/main) + +### Chỉnh sửa tệp .env + +Sao chép .env.example vào .env và điền các giá trị thích hợp. + +``` +cp .env.example .env +``` + +Lưu ý: .env là tùy chọn. Nếu bạn đang có kế hoạch chạy nhiều tác nhân riêng biệt, bạn có thể truyền secret qua định dạng JSON. + +### Tự động khởi động Eliza + +Điều này sẽ chạy mọi thứ để thiết lập dự án và khởi động bot với tính cách (character) mặc định. + +```bash +sh scripts/start.sh +``` + +### Chỉnh sửa tập tin tính cách + +1. Mở `agent/src/character.ts`, để chỉnh sửa tính cách mặc định. Bỏ chú thích và chỉnh sửa. + +2. Để chạy các tính cách tùy chỉnh: + - Sử dụng `pnpm start --characters="path/to/your/character.json"` + - Nhiều tính cách có thể được chạy cùng lúc với nhau +3. Kết nối với X (Twitter) + - Thay đổi `"clients": []` thành `"clients": ["twitter"]` ở trong tập tính cách (character) để kết nối với X. + +### Bắt đầu Eliza theo cách thủ công + +```bash +pnpm i +pnpm build +pnpm start + +# Dự án cải tiến rất nhanh, đôi khi bạn cần phải dọn dẹp dự án nếu bạn quay lại dự án +pnpm clean +``` + +#### Yêu cầu bổ sung + +Bạn có thể cần cài đặt Sharp. Nếu bạn thấy lỗi khi khởi động, hãy thử cài đặt bằng lệnh sau: + +``` +pnpm install --include=optional sharp +``` + +### Cộng đồng & Liên hệ + +- [GitHub Issues](https://github.com/elizaos/eliza/issues). Phù hợp nhất cho: các lỗi bạn gặp phải khi sử dụng Eliza và các đề xuất tính năng. +- [Discord](https://discord.gg/ai16z). Phù hợp nhất cho: chia sẻ ứng dụng của bạn và giao lưu với cộng đồng. + +## Người đóng góp + + + + + +## Lịch sử Star cho repo + +[![Star History Chart](https://api.star-history.com/svg?repos=elizaos/eliza&type=Date)](https://star-history.com/#elizaos/eliza&Date)