oboto

<p align="center">
  <img src="tray-app/assets/oboto-icon-bw.png" alt="Oboto" width="128" height="128" />
</p>

<h1 align="center">Oboto</h1>
<p align="center"><strong>Your AI-Powered Everything Assistant</strong></p>

<p align="center">
  <a href="https://github.com/sschepis/oboto/releases/latest"><img src="https://img.shields.io/github/v/release/sschepis/oboto?label=download&style=for-the-badge" alt="Download" /></a>
  <img src="https://img.shields.io/badge/platform-macOS%20%7C%20Windows-blue?style=for-the-badge" alt="Platform" />
  <img src="https://img.shields.io/badge/license-MIT-green?style=for-the-badge" alt="License" />
</p>

---

**Oboto** is an advanced AI assistant built to make you more productive, efficient, and successful — across every domain. From software engineering and project management to research, automation, and creative work, Oboto combines a persistent cognitive architecture with deep system integration to act as your tireless partner in getting things done.

## 📥 Download

| Platform | Download | Notes |
|----------|----------|-------|
| **macOS** (Apple Silicon) | [Oboto-1.2.0-arm64.dmg](https://github.com/sschepis/oboto/releases/latest) | Code-signed, requires macOS 10.12+ |
| **macOS** (zip) | [Oboto-1.2.0-arm64-mac.zip](https://github.com/sschepis/oboto/releases/latest) | Portable zip archive |
| **Windows** | [Build via GitHub Actions](https://github.com/sschepis/oboto/actions/workflows/build-windows.yml) | NSIS installer + portable exe |

## 🚀 Key Features

### Core Architecture
*   **🤖 Multi-Agent Architecture** — Multiple parallel conversations per workspace, background tasks, recurring schedules, and an autonomous agent loop. Conversations share workspace memory and report findings back to a central command. See [Multi-Agent Architecture](docs/architecture/multi-agent.md).
*   **🧠 Consciousness Processor** — Simulates an "inner life" with state persistence, ambiguity resolution (Semantic Collapse), and embodied cognition (Somatic Engine) for more coherent reasoning.
*   **🏗️ Structured Development** — Enforces architectural discipline via a "Living Manifest" (`SYSTEM_MAP.md`), ensuring code changes align with global invariants and design phases.

### AI Provider Support
*   **Multi-Provider** — Switch seamlessly between OpenAI, Google Gemini, Anthropic Claude, Google Vertex AI (Claude on GCP), local LLM Studio, and in-browser WebLLM models.
*   **Model Routing** — Route specific task types (agentic, reasoning, summarization, code completion) to different models for cost/quality optimization.
*   **Auto-Detection** — Provider is inferred automatically from the model name or can be set explicitly.

### Integrations
*   **🔌 OpenClaw** — Delegate tasks to external agents for cross-system coordination.
*   **🔌 MCP Support** — Connect to any Model Context Protocol server for dynamic tool extension.
*   **☁️ Cloud Sync** — Real-time cloud synchronization for conversations, files, and workspaces with presence indicators and multi-device support.

### User Interface
*   **🖥️ Generative UI (Surfaces)** — Spawn dynamic React dashboards on the fly to visualize data or create custom control panels.
*   **❓ Integrated Help System** — Contextual help tooltips, searchable help panel, guided tours, feature spotlights, smart suggestions, and "What Is This?" mode for exploring the interface.
*   **🧙 Setup Wizard** — Guided first-run onboarding that walks through provider selection, API key configuration, workspace setup, and optional OpenClaw integration.
*   **🎨 UI Themes** — Customizable themes with live preview and theme editor.
*   **⌨️ Keyboard Shortcuts** — Global command palette (`Cmd+K`), keyboard shortcuts reference, and guake-style terminal.

### Desktop & Browser
*   **🖥️ System Tray App** — Electron-based tray application for running Oboto as a persistent background service with workspace management and auto-start on login.
*   **🌐 Chrome Extension** — Full browser automation and control via a Chrome extension that connects to the Oboto server over WebSocket.

### Developer Features
*   **📦 Library API** — Embeddable as an npm package (`@sschepis/oboto`) with a programmatic API for task execution, streaming, design-and-implement workflows, and custom tool registration.
*   **🔐 Secrets Vault** — AES-256-GCM encrypted secrets storage for API keys and credentials, managed through the UI or CLI.

## 🔌 Plugin Ecosystem

Oboto ships with 30 built-in plugins, each extending capabilities in a specific domain:

| Plugin | Description |
|--------|-------------|
| **browser** | Puppeteer-based browser automation |
| **canvas-viz** | Canvas-based data visualization |
| **chrome-ext** | Chrome extension integration |
| **code-interpreter** | Sandboxed code execution environment |
| **document-reader** | PDF, DOCX, and document parsing |
| **embed** | Vector embedding operations |
| **firecrawl** | Web scraping and crawling |
| **hello-world** | Plugin development template |
| **html-artifacts** | HTML artifact rendering |
| **image** | AI-powered image generation and manipulation |
| **knowledge-graph** | Semantic knowledge graph with memory fields |
| **logger** | Structured logging |
| **math** | Wolfram-style computation via mathjs |
| **math-anim** | Animated mathematical explanations using a Manim-inspired DSL |
| **note-taker** | Note capture and organization |
| **notification-center** | System notifications |
| **openclaw** | External agent task delegation |
| **personas** | Agent personality management |
| **poorman-alpha** | Symbolic math via SymPy bridge |
| **prompt-editor** | System prompt editor |
| **secure-backup** | Encrypted workspace backups |
| **semantic-search** | Semantic document search |
| **temporal-voyager** | Conversation time-travel |
| **thought-stream-debugger** | Agent reasoning debugger |
| **tts** | Text-to-speech (ElevenLabs, OpenAI) |
| **ui-themes** | Theme management and editor |
| **voice-suite** | Voice input/output providers |
| **web-search** | Web search via Serper API |
| **workflow-weaver** | Visual workflow builder |
| **workflows** | Multi-step workflow automation |

## 🛠️ Tool Categories

| Category | Tools | Description |
|----------|-------|-------------|
| **File Operations** | read, write, search, diff | File CRUD with safety guards |
| **Shell** | execute | Sandboxed command execution |
| **Browser** | navigate, click, type, screenshot | Puppeteer-based browser automation |
| **Chrome Extension** | tabs, DOM, CDP, cookies | Full Chrome browser control via extension |
| **Desktop** | mouse, keyboard, screen | Native desktop automation via nut.js |
| **Image** | generate, edit, analyze | AI-powered image generation and manipulation |
| **Math** | evaluate, symbolic | Wolfram-style computation via mathjs |
| **Web** | fetch, search | Web requests and search via Serper |
| **Structured Dev** | manifest, flow, bootstrap | Project scaffolding and architecture |
| **MCP** | connect, call | Model Context Protocol server integration |
| **OpenClaw** | delegate, status | External agent task delegation |
| **Workflows** | create, run, schedule | Multi-step workflow automation |
| **Surfaces** | create, update, delete | Dynamic React dashboard generation |
| **Async Tasks** | spawn, status, cancel | Background task management |
| **Personas** | set, list, create | Agent personality management |
| **Skills** | install, list, invoke | Modular skill system |
| **Embeddings** | embed, search | Vector embedding operations |
| **TTS** | speak | Text-to-speech via ElevenLabs/OpenAI |

## 📚 Documentation

Detailed documentation is available in the [`docs/`](docs/) directory:

*   [**System Overview**](docs/architecture/overview.md) — High-level architecture, components, and data flow
*   [**Multi-Agent Architecture**](docs/architecture/multi-agent.md) — Parallel conversations, background tasks, agent loop
*   [**Consciousness Architecture**](docs/architecture/consciousness.md) — Infer

[truncated…]