uCore is a local-first, AI-powered development daemon that unifies syntax, automation, and runtime management.
Port: 8484 | Stack: Python 3.12 + aiohttp + SQLite + Vue 3 + TypeScript
curl -fsSL https://raw.githubusercontent.com/uDosGo/uCore/main/scripts/bootstrap.sh | bashThis installs Homebrew, Python 3.12, Node.js 22, pnpm, clones uCore, and starts everything.
The installer also validates and syncs locked vendor modules for a consistent uDos experience (SnackMachine core, udos-agents, udos-budget, udos-identity).
git clone https://github.com/uDosGo/uCore.git
cd uCore
./scripts/setup.sh# Refresh lock metadata from vendor/sources.yaml and validate
./scripts/vendor_sync.sh --refresh-lock --check
# Install locked Python vendor modulessource .venv/bin/activate
./scripts/vendor_sync.sh --install-python --checkcurl http://localhost:8484/api/health
# Look for 🍿 in the macOS menu bar# Frontend: http://localhost:5175./scripts/install.sh --uninstalluCore includes a manual workflow for SnackMachine integration smoke:
- Workflow name: SnackMachine Smoke
- Workflow file: .github/workflows/snackmachine-smoke.yml
- Trigger: Actions -> SnackMachine Smoke -> Run workflow
Inputs:
- ucore_url (default: http://127.0.0.1:8484)
- frontend_url (default: http://localhost:5175)
- snackmachine_path (default: $HOME/Code/SnackMachine)
Self-hosted runner prerequisites:
- uCore backend running and reachable at ucore_url
- uCore frontend running and reachable at frontend_url
- SnackMachine repo checked out at snackmachine_path
- Python 3 available on runner PATH
What it runs:
- bash scripts/smoke_snackmachine_integration.sh
uCore is the host platform core. Optional capabilities — workflow, knowledge, and domain plugins — live in dedicated repos and plug in via a lightweight extension contract.
Codex (external development) → Git/GitHub → uCore (port 8484)
uCore guided agents → Ollama/OpenRouter/OpenAI APIs
│
├── Core shell (uCore host-only)
│ ├── Skills (15 built-in) — backup, sync, route, ask vault
│ ├── Secrets — AES-256-GCM encrypted store
│ ├── Chat — AI providers via OpenRouter/Ollama/Gemini
│ ├── Surfaces (10) — Dashboard, Assistant, Server, Developer,
│ │ System, Workflow, SnackMachine, BrowserUI,
│ │ Documentation, uCode
│ ├── Plates — Vault plates, surface templates (Cookiecutter)
│ ├── Hivemind — MCP orchestration, template verification, audit
│ ├── TOON Context Optimization — Token-optimized context encoding
│ └── Flow-LLM Router — Cost-optimized routing with analytics
│
├── Extension Registry (plugin contract)
│ ├── Discovery — scans for ucore-extension.json manifests
│ ├── Loading — imports and calls setup(app) on each extension
│ └── Routing — delegates /api/* prefixes to extensions
│
├── Adaptable (moving to dedicated repos)
│ ├── uFlow — workflow engine, runs, logs, task orchestration
│ └── uKnowledge — vault search, semantic search, indexing
│
└── Plugins (udos-* prefix)
└── HomeNest/modules/home-ops/udos-home — starter domain plugin module
→ Roundtable MCP → parallel Claude/Gemini/OpenRouter execution
| Repo | Kind | Purpose | Location |
|---|---|---|---|
| uCore | host/core | Platform daemon + extension registry | ~/Code/uCore |
| uFlow | workflow | Workflow engine, runs, logs, tasks | ~/Code/uFlow |
| uKnowledge | knowledge | Vault search, semantic search, indexing | ~/Code/uKnowledge |
| uCode | runtime | Base runtime and core grid/code foundation | ~/Code/uCode |
| uCode2 | runtime | Advanced runtime layer (later extension) | ~/Code/uCode2 |
| HomeNest | plugin (udos) | Home automation + app-layer runtime | ~/Code/HomeNest |
| uDocs | docs | Canonical documentation | GitHub |
- Dedicated third-party workspace sync inside uCore is deprecated.
- Vault content should remain portable and work in standard editors such as Obsidian without uCore-specific lock-in.
- Primary editing happens in the in-product Markdown editor for first-class document workflows.
- Task flows should link to markdown specs/docs when deeper implementation details are required.
During the repo split, uCore keeps routing adapters (
app.extensions.adapters/) as import bridges only. Missing required external repos must fail fast.
| Surface | Route | Description |
|---|---|---|
| Dashboard | / | Main landing, Dev Mode filtering |
| Intelligence | /intelligence | Chat, planning, models, agents, budget, and history |
| Snackbar | /snackbar | Services, feeds, skills, snacks, extensions, logs, and MCP |
| Developer | /developer | Developer tools |
| System | /system | System settings |
| Workflow | /workflow | Workflow builder |
| SnackMachine | /snackbar?tab=snacks | Core snack workspace (packaged snacks via SnackMachine extension) |
| BrowserUI | /browserui | Browser automation |
| Documentation | /documentation | Docs viewer |
| uCode | /ucode | uCode runtime bridge: GridCore, GridSmith, teletext, terminal widgets |
Canonical docs live in uDocs:
| Section | Description |
|---|---|
| Architecture | System topology, data flow, security |
| API Reference | All endpoints with examples |
| Runbooks | Setup, deploy, backup, troubleshooting |
| Surfaces | All 12 surfaces |
| Agent Architecture | Guided model routing and orchestration |
Local docs in docs/ cover vault plates, USX layout, and system specs.
curl http://localhost:8484/api/health # Health check
curl http://localhost:8484/api/skills # 15 skills
curl http://localhost:8484/api/tools # 7 tools
curl http://localhost:8484/api/models # 4 providers
curl http://localhost:8484/api/secrets # Encrypted store
curl http://localhost:8484/api/mcp/tools # MCP tools
curl http://localhost:8484/api/knowledge/workspaces # Vault workspace bridge- 301 backend tests — all passing
- 0 TypeScript errors — clean build
- 15 built-in skills — auto-discovered
- 4 AI providers — Ollama, OpenRouter, Claude, Gemini
- 12 surfaces — Vue 3 + USX layout system
- Plates system — Vault plates, surface templates, destroy patterns
Apache 2.0 — see LICENSE.