SuperAI

SuperAI is a multi-model AI orchestration platform: plan → route → execute → learn, with safety rails.

Canonical tree: this repo (Documents\Personal\github\SuperAI).
Resume: TASKBOARD.md (index) · TASKBOARD_GROK.md · TASKBOARD_AGY.md · Docs map: docs/README.md · Scorecard: docs/V1_V6_UNIFIED_IMPROVED_SCORECARD.md

Status (2026-07-16): Feature backlog (M/S/N waves 1–2) implemented in code.
Memory Palace default: pgvector (Postgres) or SQLite cosine offline; Chroma removed.
Remaining: host smoke only (API keys, live bots, rclone, GitHub Pages, live Postgres).
Install: superai install (host tools + optional Postgres, Memory Palace Postgres defaults to Yes).

Layout

src/
  cli/     # Typer CLI + web/PWA  (import: scli)
  core/    # domain logic         (import: core)
extensions/vscode-superai/   # VS Code extension scaffold

Entry point: superai → scli.main:app

Install

cd C:\Users\burhan.husain\Documents\Personal\github\SuperAI
pip install -e ".[dev]"
# Optional: pip install -e ".[web]" ".[embeddings]" ".[vector]" ".[data]"

# Guided install (opt-in host tools + optional Postgres/pgvector)
superai install
# Non-interactive Postgres opt-in (after Postgres is available / with admin rights):
#   superai install --with-postgres --live --yes
#   superai install-postgres --setup-only --live

superai doctor

Postgres is not installed silently. On superai install, the Memory Palace Postgres step defaults to Yes (press Enter to accept); decline with n to keep SQLite under ~/.superai/memory. Live package/DB changes still need an explicit live confirm. superai install can detect local Postgres, install via winget/brew/apt if missing, create DB + vector extension, and write memory_dsn into config.

Local MCP (other AIs share SuperAI Memory Palace):

superai mcp-config --write    # ~/.superai/mcp_client_config.json for Claude/Cursor
superai mcp-serve             # stdio MCP server
# HTTP: superai web  →  POST /mcp  ·  GET /api/mcp/tools

Host tools (git, gh, aws, claude, gemini, …) are not bundled in the SuperAI package. They are detected on PATH and can be installed via winget/brew/apt/pip/npm:

superai host-tools check --profile full
superai host-tools install --profile core --dry-run   # preview
superai host-tools install --profile agentic --live   # install missing
# Or one-shot bootstrap (pip + host-tools dry-run):
powershell -File scripts\bootstrap.ps1
# Live host installs:
powershell -File scripts\bootstrap.ps1 -Profile agentic -LiveHostTools
# Optional auto on init/onboard:
$env:SUPERAI_AUTO_HOST_TOOLS = "1"        # dry-run core
$env:SUPERAI_AUTO_HOST_TOOLS = "install"  # live core

Quick start

superai run "Create a FastAPI hello world" -v --format json
superai chat "explain the last task" --new
superai tdd "add a unit test for X"
superai web   # http://127.0.0.1:8787  and  /pwa/

Docs

Doc	Purpose
TASKBOARD.md	Index · live status
TASKBOARD_GROK.md	Grok owner board
TASKBOARD_AGY.md	AGY owner board
docs/README.md	Docs map (active vs archive)
docs/V1_V6_UNIFIED_IMPROVED_SCORECARD.md	Strict scorecard
FEATURES.md	Feature matrix
QUICK_REFERENCE.md	Commands
docs/SECURITY_REVIEW.md	Security
docs/architecture.md	Architecture
docs/CODE_INTELLIGENCE.md	Native and advanced local code intelligence
CHANGELOG.md	Release notes
AGENTS.md	Agent rules

Feature summary

Orchestration, multi-provider routing, bandit/A/B, memory (pgvector / SQLite cosine / optional FAISS), skills, encrypted backup, council/hierarchy, tool proposals, doctor/chat/TDD/diff-edit, compliance, GDPR forget, MCP, PWA, VS Code extension, guided superai install, and more — see FEATURES.md.

Deferred (host): live multi-provider E2E, live Telegram/Slack, rclone remote, Pages enable.

License

MIT — see LICENSE.