+9
Daily
19,882
stars
5,898
forks
143
watchers
28,434
prs
8,518
issues
19
releases
README
elizaOS
Your agentic operating system.
Eliza ·
Eliza Cloud ·
elizaOS downloads ·
Documentation
elizaOS is an open-source TypeScript framework and product stack for autonomous
AI agents. This monorepo contains the core runtime, the Eliza app, the CLI,
cloud services, native bridges, and first-party plugins. Android
distribution tooling lives in packages/os.
Choose a starting point
| Goal | Start here |
| --- | --- |
| Use Eliza | Open the web app, visit Eliza downloads, or use a published GitHub release |
| Run this repository | Follow Run Eliza from source |
| Build an agent or plugin | Start with the runtime and the developer docs |
| Contribute | Read the required contribution rules and AGENTS.md |
| Run a whole device as elizaOS | Start with the build requirements and target guides in packages/os |
Run Eliza from source
The repository pins Bun and Node versions in package.json.
Install Bun, then:
bash
git clone --filter=blob:none https://github.com/elizaos/eliza.git
cd eliza
bun install
bun run dev
bun install also prepares submodules and patches, provisions supported host
build prerequisites, and builds or verifies the staged host
libelizainference. The embedding GGUF remains runtime-managed and downloads
automatically during local-inference warmup. Fetch archived artifact fixtures explicitly with
bun packages/scripts/fetch-archive-artifacts.ts when needed.
Common repository commands:
bash
bun run dev:local app + API with the runtime chooser (local agent, own provider keys; Cloud sign-in not required)
bun run start run the standalone agent host (API only, no UI; use bun run dev for the app)
bun run build build the workspace with Turbo
bun run verify dependency, type, lint, and audit gates
bun run test:quint application state models and invariants
bun run test:lemma verified TypeScript helpers (Dafny 4.11.0 required)
bun run test repository end-to-end test lane
bun run test:e2e end-to-end lane
bun run cloud:mock local Eliza Cloud stack with mocks
Package build/test commands are in each package's README. Use
bun run --cwd to scope a command.
Runtimes
Bun 1.4.2 (packageManager) runs the product, the build, bun run verify, and
the repository scripts: run a script with bun .ts. Node 24.15.0
(engines.node) is needed only for the lanes below. They fail on Bun 1.4.2,
could not be shown to pass on it, or must prove behavior on Node:
- Vitest. packages/scripts/run-vitest.ts always starts Vitest on Node. Bun
fails suites that Node passes (fetch of an uppercase DATA: URL,
http.Server.closeAllConnections, child Node ESM probes).
- LemmaScript checks use pinned LemmaScript 0.6.8 and Dafny 4.11.0. The
checked helpers and solver options are in LemmaScript-files.txt.
- Quint conformance replays (check-quint.ts without --inventory), because
they run Vitest.
- node --test suites that use module.stripTypeScriptTypes, built-in module
mocks, or a nested Wrangler. Their Top issues
#39651[VIBESTACK] Finish the Eliza core specification and replacement0 comments · 2026-11-14#39650[VIBESTACK] Complete Eliza specification, verification, and compatible core replacement0 comments · 2026-11-14
Discussions
#39474Withdrawn by author1 comments · 2026-11-12#39100[Plugin / B2A Infrastructure] Mr. Vesper: Autonomous CONUS Physical Fulfillment, Phygital NFC Apparel & OOH Brokerage1 comments · 2026-11-09#38870[RFC] Runaway tool loops have zero deterministic budget defense against prompt injection0 comments · 2026-11-06#38605Community example: an Eliza agent buys a finished research job over x4021 comments · 2026-11-02#38002Show and tell: Hardening MCP Database & SQL Tools for Autonomous Agents — CTE Defenses, Read-Only Guardrails & Stdio Isolation0 comments · 2026-10-27#37844Risk limits for trading agents, with no whole exchange key in the agent0 comments · 2026-10-26#37308Pre-swap honeypot guard for plugin-evm swaps (elizaos-plugin-devx-tokencheck)0 comments · 2026-10-22#37301NOVA: remote MCP and x402 tools for elizaOS agents (JSON repair $0.01, cited research $0.99, USDC on Base)0 comments · 2026-10-22
Latest release
v2.0.5 v2.0.5 2026-11-11All 81 npm cohort packages are available as version 2.0.5 on latest. The source is c094a549fee09f6e06911b8486b9789b536401aa from develop. Use exact versions to install this release: sh npm install @elizaos/[email protected] npm install @elizaos/[email protected] The public tarball bytes, sizes, package names, versions, source IDs and publisher records matched the immutable release plan for all 81 packages. The attached plan is the original plan. The attached validation record gives the observation times, package hashes and evidence hashes. This GitHub record uses a manual metadata recovery lane. Canon