
Eliza
An open-source TypeScript framework and app stack for building autonomous AI agents.
- Stars
- 19.8k
- Forks
- 5.9k
- Licence
- MIT
- Language
- TypeScript
- Last update
- 4 days ago
- Type
- Framework
What it is
elizaOS is an open-source TypeScript project for running autonomous AI agents. It includes a core runtime, a user-facing Eliza app for web, desktop, and mobile, a command-line tool, cloud services, and first-party plugins that add abilities such as chat, memory, messaging connectors, and browser automation. The README describes it as model-agnostic, so it can use local models or hosted model providers.
- Run the Eliza app from source with local agent mode using your own model provider keys
- Start the standalone agent host as an API-only service with bun run start
- Embed the @elizaos/core runtime directly in your own TypeScript project
- Build a first-party style plugin that registers actions, providers, or services
- Run the local Eliza Cloud stack with mocks for testing
Great for
- Developers who want to build AI agents or plugins in TypeScript
- People who want a personal AI assistant they can run on their own hardware or with their own provider keys
- Teams experimenting with local inference using the Eliza-1 on-device path
- Builders who want a modular plugin system for actions, providers, and services
Not ideal for
- Beginners who want a simple one-click chat app: the repository setup assumes Bun, Node versions, and command-line work
- People who need a stable, minimal library: the README describes a large monorepo with many packages and optional cloud services
- Anyone who wants to submit third-party plugins: the README says third-party plugins and registry listings are no longer accepted
How to get it
- 1
Clone and build from source
You'll need: Bun (version pinned in package.json) · Node.js (version pinned in package.json) · Git · Python 3.11+ (only for benchmarks)
Clone the repository
git clone --filter=blob:none https://github.com/elizaos/eliza.gitEnter the folder
cd elizaInstall dependencies
bun installStart the app
bun run dev - 2
Run it
- Install the Bun and Node versions pinned in package.json
- Clone the repository and run bun install
- Run bun run dev to start the app
- Or run bun run dev:local to use a local agent with your own provider keys without Cloud sign-in
- 3
Get the most out of it
- Use bun run --cwd <package> <script> to scope commands to one package
- Read each package's README before making changes, as the repository asks
- Use bun run verify to run dependency, type, lint, and audit checks
- Configure local inference or direct model providers to avoid depending on Eliza Cloud
- Explore the plugin component guide at docs.elizaos.ai to add actions, providers, or services
Downloads
Strengths
- Open source under the MIT license, with a public repository and documentation links
- Model-agnostic design that supports local, direct-provider, or cloud model backends
- Modular plugin structure with documented component types and a clear package layout
Trade-offs
- Large, fast-changing monorepo; the README is truncated and some capabilities depend on OS, permissions, and installed plugins
- Contribution rules are strict and the project does not accept third-party plugins
- Some features such as live benchmarks may incur model provider costs
How it compares
| Project | Stars | Type | Level | Updated | Best for |
|---|---|---|---|---|---|
| eliza (this) | 19.8k | Framework | advanced | 4 days ago | Developers who want to build AI agents or plugins in TypeScript |
| langchain | 149k | Framework | intermediate | 4 days ago | Python developers building LLM-powered applications |
| crewAI | 60.4k | Library | intermediate | 4 days ago | Python developers prototyping multi-agent workflows |
| deer-flow | 84.9k | AI model / agent | advanced | 4 days ago | Developers who want to experiment with multi-agent workflows on their own infrastructure |
| botpress | 15k | Dev tool | intermediate | 6 days ago | Developers who want to write integrations and bots as TypeScript code using the Botpress CLI and SDK |
| claude-context | 12.7k | Dev tool | beginner | 4 months ago | Developers working in large codebases where loading everything into an agent's context is impractical |
Stats synced from GitHub. The assessment above was drafted with AI from the project's README on 2026-10-29 and may miss recent changes — check the README before relying on a command. MIT licence: free to use, modify and distribute, including commercially, as long as you keep the copyright notice.