AmitOS — Universal AI OS

One surface to deploy, research, remember, and control every device. Designed for ADHD and dyslexia: scan in 5 seconds, neon clarity, big touch targets.

---

⬇️ One-Click Install

Platform	Download
macOS (Universal .dmg)	AmitOS_1.0.0_universal.dmg
Windows (.exe installer)	AmitOS_1.0.0_x64-setup.exe
Linux (.AppImage)	AmitOS_1.0.0_amd64.AppImage
Android APK (Panda companion)	AmitOS_1.0.0.apk
Raspberry Pi ARM64	amitos-arm64

One-click RPi install:

curl -fsSL https://raw.githubusercontent.com/your-org/amitos/main/scripts/build-rpi.sh | bash

---

🎙️ Voice Demo (30 seconds)

1. Open AmitOS → Voice + Chat tab
2. Say: "Open my email and summarize unread messages"
3. Vy (desktop agent) reads your screen, Panda (phone) shows approval prompt
4. Tap Allow on your phone → task executes in background
5. Memory Spine logs the action, Kaizen Task auto-created for review

---

What's Inside

Feature	Description
🖥️ Vy Desktop Agent	AI agent with vision + mouse/keyboard. Takes over desktop with per-action approval
🐼 Panda Phone Control	Android companion for remote approvals, voice capture, today-board
🎙️ Voice + Chat	Web Speech API, intent parser, real-time chat UI
♾️ Kaizen Tasks	Auto-created from every agent action. Kanban board, priorities, domains
🧠 Memory Spine	Every action logged with cost tracking. Searchable, persistent
☁️ VPS + RPi Deploy	One-click SSH deploy to any server. Systemd daemon + WebSocket sync
🔌 MCP Browser	Playwright, Firecrawl, GitHub MCP — toggle on/off, get instant config
📱 Mobile Sync	QR-code pairing for real-time sync with Android companion
🔑 50+ API Providers	Tauri Stronghold vault, zero plaintext. Auto-injected into every tool
⚡ Parallel Execution	Run 5 agent tasks simultaneously across desktop, phone, VPS, RPi
🚀 Deploy Any Repo	Clone, setup, inject keys, and launch any GitHub/HF repo with one click
🛠️ Tool Registry	superpowers, diffusionstudio/agent, Firecrawl, Apify — 35+ tools pre-wired

---

Quick Start (3 minutes)

# 1. Clone
git clone https://github.com/your-org/amitos
cd amitos

# 2. Install Bun (fastest JS runtime)
curl -fsSL https://bun.sh/install | bash

# 3. Install deps + run desktop app
bun install
bun run tauri dev

Or just download the installer and skip the build step.

---

Adding Your First API Key

1. Open AmitOS → API Keys tab
2. Search for your provider (50+ listed: OpenAI, Anthropic, Fal.ai, Firecrawl…)
3. Click the provider card → paste your API key → Save
4. Go to any tool → your key is auto-injected

---

Vy Desktop Agent

Vy watches your screen and executes with explicit approval:

Start session → describe task → Vy takes screenshot
→ plans actions → each action requires your approval
→ executes (click, type, scroll) → logs to Memory Spine
→ creates Kaizen task for review

Example tasks:

• "Watch this tutorial and set up the dev environment"
• "Fill the W2 form in Excel using my tax documents"
• "Update all Notion project pages with today's progress"
• "Run my test suite and fix any failures"

---

Panda Phone Control

Your phone becomes a remote control for AmitOS:

1. Download the Android APK (link above or QR in Mobile tab)
2. Open → scan QR code shown in AmitOS
3. See pending approval requests in real time
4. One tap to approve or deny any Vy desktop action
5. Voice capture: speak tasks → synced to desktop instantly

---

Architecture

AmitOS (Tauri 2.0 + SvelteKit + Bun)
├── Frontend (SvelteKit, Svelte 5, Tailwind 4)
│   ├── Dashboard — system health, quick actions
│   ├── Vy Agent — desktop computer control
│   ├── Panda — phone remote control
│   ├── Voice — Web Speech API + chat
│   ├── Kaizen — task management (Kanban)
│   ├── Memory — persistent knowledge spine
│   ├── MCP Browser — model context protocol
│   ├── Tools — 35+ pre-wired AI tools
│   ├── Workflows — overnight chain execution
│   ├── Deploy — one-click to PC/Colab/VPS/RPi
│   ├── Mobile Sync — QR pairing
│   └── API Keys — 50+ provider vault
│
└── Backend (Rust, Tauri 2.0)
    ├── Computer Agent — Vy vision + mouse/keyboard
    ├── Voice Assistant — chat sessions + push notifications
    ├── Provider Registry — 50+ providers, SQLite-backed
    ├── Memory Spine — API usage logs + knowledge entries
    ├── Kaizen Tasks — auto-created tasks from every action
    ├── Orchestrator — deploy flows (PC, Colab, VPS, RPi)
    ├── Tool Registry — manifest-driven tool launcher
    └── Stronghold — zero-plaintext key vault (Argon2)

---

Builds

Platform	Command	Output
All desktop	bun run tauri build	.dmg, .exe, .AppImage
macOS universal	bun run tauri build --target universal-apple-darwin	Universal .dmg
Android APK	bun run tauri android build --apk	.apk
Raspberry Pi	bash scripts/build-rpi.sh	ARM64/ARMv7 binary

CI/CD: GitHub Actions builds all platforms on every tag push.

---

Test Coverage

Run the system health check from the Dashboard → Run Check button.

Verified end-to-end flows:

• ✓ Voice command → parallel agent execution → Memory Spine → Kaizen task
• ✓ Vy desktop takeover with per-action phone approval
• ✓ Panda APK → ADB bridge → Android Accessibility Service
• ✓ VPS deploy → systemd daemon → WebSocket sync
• ✓ RPi ARM64 deploy via SSH
• ✓ MCP Playwright → browser control → screenshot capture
• ✓ 50+ API provider auto-injection into any tool

---

License

MIT — see LICENSE

---

Contributing

1. Fork → branch → PR
2. Run bun run check before submitting
3. All PRs run CI (frontend build + Rust clippy)

---

AmitOS is built for people who need to do a lot, forget nothing, and control everything — from one beautiful surface.