{"id":23591697,"url":"https://github.com/elizaos/eliza","last_synced_at":"2026-04-26T15:02:25.652Z","repository":{"id":247548424,"uuid":"826170402","full_name":"elizaOS/eliza","owner":"elizaOS","description":"Autonomous agents for everyone","archived":false,"fork":false,"pushed_at":"2026-04-21T05:33:39.000Z","size":1808743,"stargazers_count":18222,"open_issues_count":14,"forks_count":5493,"subscribers_count":155,"default_branch":"develop","last_synced_at":"2026-04-21T05:38:07.038Z","etag":null,"topics":["agent","agentic","ai","autonomous","chatbot","crypto","discord","eliza","elizaos","framework","plugins","rag","slack","swarm","telegram"],"latest_commit_sha":null,"homepage":"https://eliza.how/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/elizaOS.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-07-09T07:55:40.000Z","updated_at":"2026-04-21T04:29:13.000Z","dependencies_parsed_at":"2024-07-29T02:28:48.207Z","dependency_job_id":"bdf7a7eb-6567-4f43-98b8-dacfdd4ff4ee","html_url":"https://github.com/elizaOS/eliza","commit_stats":null,"previous_names":["rubyresearch/rubyagent","rubyresearch/agent","rubyresearch/eliza","lalalune/eliza","elizaos/eliza"],"tags_count":640,"template":false,"template_full_name":null,"purl":"pkg:github/elizaOS/eliza","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elizaOS%2Feliza","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elizaOS%2Feliza/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elizaOS%2Feliza/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elizaOS%2Feliza/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/elizaOS","download_url":"https://codeload.github.com/elizaOS/eliza/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/elizaOS%2Feliza/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32103747,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-21T11:25:29.218Z","status":"ssl_error","status_checked_at":"2026-04-21T11:25:28.499Z","response_time":128,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","agentic","ai","autonomous","chatbot","crypto","discord","eliza","elizaos","framework","plugins","rag","slack","swarm","telegram"],"created_at":"2024-12-27T08:00:31.781Z","updated_at":"2026-04-24T05:05:19.399Z","avatar_url":"https://github.com/elizaOS.png","language":"TypeScript","funding_links":[],"categories":["🏢 Official Developer Resources"],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003ch1\u003eelizaOS\u003c/h1\u003e\n  \u003cp\u003e\u003cstrong\u003eThe Open-Source Framework for Multi-Agent AI Development\u003c/strong\u003e\u003c/p\u003e\n  \u003cp\u003eBuild, deploy, and manage autonomous AI agents with a modern, extensible, and full-featured platform.\u003c/p\u003e\n\u003c/div\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://trendshift.io/repositories/12591\" target=\"_blank\"\u003e\u003cimg src=\"https://trendshift.io/api/badge/repositories/12591\" alt=\"elizaOS%2Feliza | Trendshift\" style=\"width: 250px; height: 55px;\" width=\"250\" height=\"55\"/\u003e\u003c/a\u003e\n\u003c/p\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://www.npmjs.com/package/@elizaos/core\"\u003e\u003cimg src=\"https://img.shields.io/npm/dm/@elizaos/core\" alt=\"Downloads\" width=140 height=20\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/elizaOS/eliza/releases\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/elizaOS/eliza\" alt=\"Releases\" width=94 height=20\u003e\u003c/a\u003e\n  \u003ca href=\"https://arxiv.org/abs/2501.06781\"\u003e\u003cimg src=\"https://img.shields.io/badge/arXiv-2501.06781-b31b1b.svg\" alt=\"Paper\" width=116 height=20\u003e\u003c/a\u003e\n  \u003ca href=\"https://deepwiki.com/elizaOS/eliza\"\u003e\u003cimg src=\"https://deepwiki.com/badge.svg\" alt=\"Ask DeepWiki\" width=109 height=20\u003e\u003c/a\u003e\n\u003c/div\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://github.com/elizaos/eliza/stargazers\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/elizaos/eliza?style=for-the-badge\u0026logo=github\" alt=\"GitHub Stars\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/elizaos/eliza/network/members\"\u003e\u003cimg src=\"https://img.shields.io/github/forks/elizaos/eliza?style=for-the-badge\u0026logo=github\" alt=\"GitHub Forks\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/elizaos/eliza/commits\"\u003e\u003cimg src=\"https://img.shields.io/github/last-commit/elizaos/eliza?style=for-the-badge\" alt=\"Last Commit on GitHub\"\u003e\u003c/a\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://github.com/elizaos/eliza/blob/main/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-MIT-green?style=for-the-badge\" alt=\"License\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.npmjs.com/package/@elizaos/cli\"\u003e\u003cimg src=\"https://img.shields.io/npm/v/@elizaos/cli?style=for-the-badge\" alt=\"NPM Version\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/elizaos/eliza/graphs/contributors\"\u003e\u003cimg src=\"https://img.shields.io/github/contributors/elizaos/eliza?style=for-the-badge\" alt=\"Contributors\"\u003e\u003c/a\u003e\n\u003c/div\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://docs.elizaos.ai/\"\u003e\u003cimg src=\"https://img.shields.io/badge/Documentation-Read%20Docs-blue?style=for-the-badge\" alt=\"Documentation\"\u003e\u003c/a\u003e\n  \u003c!-- a href=\"https://github.com/elizaos/eliza/actions/workflows/image.yaml\"\u003e\u003cimg src=\"https://img.shields.io/github/actions/workflow/status/elizaos/eliza/ci.yaml?branch=main\u0026style=for-the-badge\" alt=\"CI Status\"\u003e\u003c/a --\u003e\n  \u003ca href=\"https://twitter.com/elizaOS\"\u003e\u003cimg src=\"https://img.shields.io/twitter/follow/elizaOS?style=for-the-badge\u0026logo=x\u0026label=Follow\" alt=\"Follow on X\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://discord.gg/ai16z\"\u003e\u003cimg src=\"https://img.shields.io/discord/1253563208833433701?style=for-the-badge\u0026logo=discord\" alt=\"Discord\"\u003e\u003c/a\u003e\n\u003c/div\u003e\n\n## ✨ What is Eliza?\n\nelizaOS is an all-in-one, extensible platform for building and deploying AI-powered applications. Whether you're creating sophisticated chatbots, autonomous agents for business process automation, or intelligent game NPCs, Eliza provides the tools you need to get started quickly and scale effectively.\n\nIt combines a modular architecture, a powerful CLI, and a rich web interface to give you full control over your agents' development, deployment, and management lifecycle.\n\nFor complete guides and API references, visit our official **[documentation](https://docs.elizaos.ai/)**.\n\n## 🚀 Key Features\n\n- 🔌 **Rich Connectivity**: Out-of-the-box connectors for Discord, Telegram, Farcaster, and more.\n- 🧠 **Model Agnostic**: Supports all major models, including OpenAI, Gemini, Anthropic, Llama, and Grok.\n- 🖥️ **Modern Web UI**: A professional dashboard for managing agents, groups, and conversations in real-time.\n- 🤖 **Multi-Agent Architecture**: Designed from the ground up for creating and orchestrating groups of specialized agents.\n- 📄 **Document Ingestion**: Easily ingest documents and allow agents to retrieve information and answer questions from your data (RAG).\n- 🛠️ **Highly Extensible**: Build your own functionality with a powerful plugin system.\n- 📦 **It Just Works**: A seamless setup and development experience from day one.\n\n\u003e **Looking for plugins?** Browse the community plugin registry at **[elizaOS-plugins/registry](https://github.com/elizaOS-plugins/registry)** for a full list of available ElizaOS plugins.\n\n## 🏁 Getting Started (5-Minute Quick Start)\n\nThere are two recommended paths for using Eliza:\n\n- **For Beginners \u0026 Standalone Projects (CLI):** If you want to create and deploy agents without modifying Eliza's core code, the CLI is the fastest and simplest method. The guide below is for you.\n\n- **For Power Users \u0026 Contributors (Monorepo):** If you plan to contribute to Eliza, create complex custom plugins, or manage multiple projects in one place, we recommend cloning the full monorepo. See the [How to Contribute](#-how-to-contribute) section to get started.\n\n---\n\nGet your first AI agent running in just a few commands.\n\n**Prerequisites:**\n\n- [Node.js](https://nodejs.org/) (v23+)\n- [bun](https://bun.sh/docs/installation)\n\n\u003e **Note for Windows Users:** [WSL 2](https://learn.microsoft.com/en-us/windows/wsl/install-manual) is required.\n\n### 1. Install the CLI\n\n```bash\n# Install the elizaOS CLI globally\nbun install -g @elizaos/cli\n\n# Verify installation\nelizaos --version\n```\n\n### 2. Create Your Project\n\n```bash\n# Create a new project with an interactive setup\nelizaos create my-first-agent\n\n# Follow the prompts. For beginners, we recommend:\n# - Database: pglite (no setup required)\n# - Model Provider: openai\n# - Project Type: project\n```\n\n### 3. Configure Your API Key\n\n```bash\ncd my-first-agent\n\n# Open the local environment file\nelizaos env edit-local\n```\n\nAdd your model provider's API key (e.g., for OpenAI):\n\n```env\nOPENAI_API_KEY=your_api_key_here\n```\n\n### 4. Start Your Agent\n\n```bash\n# Build and start the agent server\nelizaos start\n```\n\nYour agent is now running!\n\n- **Web Interface**: [http://localhost:3000](http://localhost:3000)\n- **API Endpoint**: `http://localhost:3000/api`\n\n---\n\n\u003cdetails\u003e\n\u003csummary\u003e📚 **Advanced CLI Commands \u0026 Usage**\u003c/summary\u003e\n\nEliza's CLI is powerful. Here are some more commands for development and management.\n\n#### Development Workflow\n\n```bash\n# Make changes to your agent code, then rebuild and restart\nbun run build\nelizaos start\n\n# Or, start in development mode with auto-rebuild\nelizaos dev\n\n# Run tests to verify your changes\nelizaos test\n```\n\n#### Agent \u0026 Environment Management\n\n```bash\n# List all available agents\nelizaos agent list\n\n# Start a specific agent by name\nelizaos agent start --name \"MyAgent\"\n\n# Show all environment variables\nelizaos env list\n```\n\n#### Debugging\n\n```bash\n# Start with detailed debug logging\nLOG_LEVEL=debug elizaos start\n```\n\nFor a full command reference, run `elizaos --help` or `elizaos \u003ccommand\u003e --help`.\n\n\u003c/details\u003e\n\n---\n\n## 🔧 Running elizaOS Core Standalone\n\nUse elizaOS agents directly in your applications without the CLI or web interface.\n\n```bash\ngit clone https://github.com/elizaos/eliza.git\ncd eliza\n\n# Interactive chat\nOPENAI_API_KEY=your_key bun run examples/typescript/chat.ts\n\n# Basic message processing\nOPENAI_API_KEY=your_key bun run examples/typescript/standalone.ts\n```\n\n## 🏛️ Architecture Overview\n\nEliza is a monorepo that contains all the packages needed to run the entire platform.\n\n```\n/\n├── packages/\n│   ├── server/         # Core backend server (Express.js)\n│   ├── client/         # Frontend web interface (React)\n│   ├── cli/            # Command-line tool for managing projects\n│   ├── core/           # Shared utilities, basic-capabilities plugin, and functions\n│   ├── app/            # Cross-platform desktop app (Tauri)\n│   ├── plugin-sql/     # Database integration (Postgres, PGLite)\n│   └── ...             # Other plugins and project starters\n└── ...\n```\n\n- **`@elizaos/server`**: The Express.js backend that runs your agents and exposes the API.\n- **`@elizaos/client`**: The React-based web UI for managing and interacting with your agents.\n- **`@elizaos/cli`**: The central tool for scaffolding, running, and managing your projects.\n- **`@elizaos/core`**: The core package that includes the basic-capabilities plugin which handles message processing and basic agent actions.\n\n## 🤝 How to Contribute\n\nWe welcome contributions from the community! Please read our `CONTRIBUTING.md` guide to get started.\n\n- **Report a Bug**: Open an issue using the [Bug Report](.github/ISSUE_TEMPLATE/bug_report.md) template.\n- **Request a Feature**: Use the [Feature Request](.github/ISSUE_TEMPLATE/feature_request.md) template.\n- **Submit a Pull Request**: Please open an issue first to discuss your proposed changes.\n\n## 📜 License\n\nThis project is licensed under the **MIT License**. See the [LICENSE](LICENSE) file for details.\n\n## 🎓 Citation\n\nIf you use Eliza in your research, please cite our paper:\n\n```bibtex\n@article{walters2025eliza,\n  title={Eliza: A Web3 friendly AI Agent Operating System},\n  author={Walters, Shaw and Gao, Sam and Nerd, Shakker and Da, Feng and Williams, Warren and Meng, Ting-Chien and Han, Hunter and He, Frank and Zhang, Allen and Wu, Ming and others},\n  journal={arXiv preprint arXiv:2501.06781},\n  year={2025}\n}\n```\n\n## Contributors\n\n\u003ca href=\"https://github.com/elizaos/eliza/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contrib.rocks/image?repo=elizaos/eliza\" alt=\"Eliza project contributors\" /\u003e\n\u003c/a\u003e\n\n## Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=elizaos/eliza\u0026type=Date)](https://star-history.com/#elizaos/eliza\u0026Date)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felizaos%2Feliza","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Felizaos%2Feliza","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felizaos%2Feliza/lists"}