yaya

A lightweight, kernel-style agent that grows itself. A single Python process (yaya serve) runs an event-driven kernel whose web UI opens at http://127.0.0.1:<port>. Everything else is a plugin — and yaya can author plugins on demand.

Read the product anchor: GOAL.

Quick start

pip install https://github.com/rararulab/yaya/releases/latest/download/yaya-<VERSION>-py3-none-any.whl
yaya --help

Requires Python 3.14+. Other install options → Install.

User Guide

• Install — binary, wheel, or source.
• Usage — commands, --json contract, examples.

Development

• Architecture — kernel + plugins layout.
• Plugin Protocol — event catalog, ABI, categories (authoritative).
• Workflow — issue → worktree → PR (MANDATORY).
• Multi-Agent — parallel dispatch, hand-off rules.
• CLI Conventions — command pattern and extension checklist.
• Web UI — yaya serve, pi-web-ui build, WS event protocol.
• Testing — just check · just test · TDD.
• Agent Spec (BDD Contracts) — ZhangHanDong/agent-spec workflow.
• Code Comments & Docstrings — Google Python Style Guide + yaya overlays.
• Release — release-please automation.

Org standards

Inherited from rararulab/.github: workflow, commit style, code comments, CLI design, anti-patterns, issue & PR templates.

License

MIT