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. Linux and Android distribution tooling lives in `packages/os`.

| 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` |

The repository pins Bun and Node versions in `package.json`. Install those versions, then:

``` 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 desktop `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.

``` 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 # 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