v0.1.0: Brain Runtime Scaffold

UBA v0.1.0 - First Public Release

What's included

• 6-layer architecture scaffold: Browser Core / Perception / Brain Engine / Planning / Reflection / Memory OS (~70% coverage)
• 15 MCP tools (8 browse_* + 5 uba_* + 2 uba_twitter_*)
• page.json v0.1 schema (Pydantic + Draft-07 JSON Schema)
• Memory OS: SQLite episodic + playbooks + preferences (3 tables)
• Brain Engine: page_type classifier, importance ranking, risk detector
• Reflection: diff-based outcome verification, 7 failure causes, retry hints
• X/Twitter Free API read-only integration (2 tools, no write)
• 49 unit tests passing
• Apache-2.0 license
• CI (ruff + pytest + e2e) and Release (PyPI trusted publishing) workflows
• Full governance docs: CONTRIBUTING, SECURITY, CODE_OF_CONDUCT
• 10 starter issues in docs/issues/backlog.md

What's NOT included (deferred to v0.2+)

• browse_with_goal (LLM decision loop)
• LanceDB semantic memory
• Site Playbook automatic learning
• Approval Policy interactive wizard
• Stealth provider abstraction (CloakBrowser / Camoufox as plugins)
• X/Twitter write (requires Basic API $100/mo)

Install

git clone https://github.com/kezhu-ai/uba.git
cd uba
uv sync
uv run uba-server

Documentation

• README.md
• CLAUDE.md - architecture contract
• CONTRIBUTING.md
• SECURITY.md
• docs/chatgpt-handoff.md
• docs/issues/backlog.md
• deep-research-report.md - see local copy for full context