elizaOS /eliza

Open source agentic operating system

★ 19,882⑂ 5,898👁 143⑃ 28,434● 8,518▤ 19
TypeScriptMITCreated 2024-07-09elizaresearch.ai/
下载:v2.0.5v2.0.5 ↓2.0.52026-11-11
+9
日增长
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

Discussions

Latest release

v2.0.5 v2.0.5 2026-11-11
All 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

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON