English | 简体中文
Composable AI runtime framework for building agent systems with tools, agents, skills, hosts, memory, workflow packages, and scenario packs.
WeaveRT is a runtime framework for building and operating agent systems. It gives you a stable runtime core plus clear extension surfaces for tools, agents, skills, hosts, permissions, memory, workflow packages, and scenario packs.
It is not a single preset assistant app. You can start with a small project-local workflow, then grow into coding, chat, or local-assistant products without rewriting the runtime model.
- Build on a runtime, not a single prompt.
- Compose tools, agents, skills, and packages without hiding ownership boundaries.
- Keep host integration, permissions, and durable state explicit.
- Start with a minimal scaffold, then grow into richer workflows and apps.
The default first run is the starter, not examples/.
Starter is the adoption path. Examples are the validation path.
From a published package index, the shortest path is:
python3 -m venv .venv
source .venv/bin/activate
python -m pip install weavert-starter weavert-testing
weavert-starter generate minimal-project ./my-weavert-app
cd my-weavert-app
python -m pip install -e .
python app.pyIf you are editing WeaveRT itself from a local source checkout, use docs/getting-started/install-from-source.md and then follow the same starter flow.
Expected first-run anchors:
preset: ordinary-workflowassistant: The scaffold is ready...status: ok
- Docs home: docs/README.md
- First run: docs/getting-started/quickstart.md
- Official starter path: docs/getting-started/starter-scaffolds.md
- Runnable validation path: examples/README.md
- I want the smallest successful project -> docs/getting-started/starter-scaffolds.md
- I want the first real project path -> docs/guides/build-your-first-project.md
- I want to understand the runtime model: read docs/introduction/what-is-weavert.md and docs/concepts/runtime-model.md
- I want to extend tools, agents, or skills: go to docs/guides/add-a-tool.md, docs/guides/add-an-agent.md, and docs/guides/add-a-skill.md
- I want host, hook, or control-plane integration: go to docs/guides/bind-a-host.md, docs/guides/extend-the-control-plane.md, and docs/guides/register-hooks.md
- I want to validate real workflows: use examples/README.md
- I maintain the repository: use docs/maintainers/repository-layout.md and docs/maintainers/migration-notes.md
- Seam basics and validation path: examples/README.md
- Ordinary coding workflow validation: examples/README.md
- Advanced host-bound integration sample: examples/apps/code_assistant/README.md
Generate a starter first unless you are specifically evaluating framework seams or validation evidence.
- Architecture overview: docs/architecture/overview.md
- Request lifecycle: docs/architecture/request-lifecycle.md
- RuntimeConfig reference: docs/reference/runtime-config.md
- Full docs index: docs/README.md
WeaveRT is under active development. The documentation is organized as a layered journey: landing page -> getting started -> concepts -> guides -> architecture/reference/maintainers.
See CONTRIBUTING.md for setup, workflow, and documentation conventions. Community expectations live in CODE_OF_CONDUCT.md, and vulnerability reporting guidance lives in SECURITY.md.
Apache-2.0. See LICENSE.