Metadata-Version: 2.4
Name: akari-cli
Version: 0.1.2
Summary: Akari Watanabe AI Assistant - Voice-first CLI & Web Assistant
Author-email: akariwill <mwildjrs23@example.com>
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: anthropic>=0.39.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: fastapi>=0.115.0
Requires-Dist: uvicorn[standard]>=0.32.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: websockets>=13.0
Requires-Dist: playwright>=1.40.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: rich>=14.3.3
Requires-Dist: python-dotenv>=1.0.1
Dynamic: license-file

  logo

  AKARI WATANABE (渡辺 星)

  A voice-first AI assistant that runs on your Mac. Talk to it, and it talks back -- with an audio-reactive particle orb.

  Akari Animation

  "おかえりなさい、あなた。"

---

## Screenshots

  Welcome Page
  Home Page

---

  AKARI connects to your Apple Calendar, Mail, and Notes. It can browse the web, spawn Claude Code sessions to build entire projects, and plan your day -- all through natural voice conversation.

---

## AKARI CLI (Terminal Version)

  AKARI CLI

Experience AKARI directly from your terminal! The CLI version is built for developers who want a fast, lightweight, and powerful interaction without opening a browser.

### CLI Features
- **Real-time Voice** -- Just like the web version, AKARI speaks to you using the local high-quality audio files or the Fish Audio API.
- **Dynamic Typing Effect** -- Responses flow naturally with a typewriter effect, synchronized with AKARI's voice.
- **Project Awareness** -- Automatically scans your Desktop for git repositories to understand your workspace context.
- **Autonomous Task Execution** -- Planning and building projects (via Claude Code) happens directly in new terminal windows without needing confirmation.
- **Integrated Memory** -- Notes, tasks, and facts are saved to the same shared database as the web version.

### Slash Commands
| Command | Description |
|---------|-------------|
| `/help` | Show help table with AKARI's voice guidance. |
| `/clear` | Clear the terminal and reset conversation context. |
| `/tasks` | List all your open tasks and reminders. |
| `/projects` | Show all detected projects on your Desktop. |
| `/restart` | Restart the CLI environment and re-initialize systems. |
| `/quit` | Sayonara! Closes the CLI with a parting message. |

### How to Run
```bash
python akari_cli.py
```
Or run with a direct command:
```bash
python akari_cli.py "build me a python script to scrape news"
```

---

## What It Does

- **Voice conversation** -- speak naturally, get spoken responses with an AKARI voice.
- **Builds software** -- say "build me a landing page" and watch Claude Code do the work.
- **Reads your calendar** -- "What's on my schedule today?"
- **Reads your email** -- "Any unread messages?" (read-only, by design).
- **Browses the web** -- "Search for the best restaurants in Austin".
- **Manages tasks** -- "Remind me to call the client tomorrow".
- **Takes notes** -- "Save that as a note".
- **Remembers things** -- "I prefer React over Vue" (it remembers next time).
- **Plans your day** -- combines calendar, tasks, and priorities into a plan.
- **Sees your screen** -- knows what apps are open for context-aware responses.
- **Audio-reactive orb** -- a Three.js particle visualization that pulses with AKARI's voice.

---

## Tech Stack

| Layer | Technology |
|-------|-----------|
| **Backend** | ![FastAPI](https://img.shields.io/badge/FastAPI-009688?style=for-the-badge&logo=fastapi&logoColor=white) ![Python](https://img.shields.io/badge/Python-3776AB?style=for-the-badge&logo=python&logoColor=white) |
| **Frontend** | ![Vite](https://img.shields.io/badge/Vite-646CFF?style=for-the-badge&logo=vite&logoColor=white) ![Three.js](https://img.shields.io/badge/Three.js-black?style=for-the-badge&logo=three.dot.js&logoColor=white) ![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?style=for-the-badge&logo=typescript&logoColor=white) |
| **AI Brain** | **Anthropic Claude (Haiku & Opus)** |
| **Voice** | **Fish Audio TTS (Akari Model)** |
| **Bridge** | **AppleScript**, **Claude Code CLI**, **Playwright** |

---

## Architecture & How it Works

AKARI operates through a high-performance voice loop and system orchestration layer:

```mermaid
graph TD
    A[User Voice] -->|Web Speech API| B[FastAPI Backend]
    B -->|Intent Detection| C{Action?}
    C -->|Chat| D[Claude Haiku]
    C -->|System Task| E[AppleScript / Shell]
    C -->|Dev Task| F[Claude Code]
    D -->|Text| G[Fish Audio TTS]
    G -->|Stream| H[Three.js Lilac Orb]
    H -->|Voice Out| I[User]
```

### How the Voice Loop Works
1. **Microphone**: Chrome's Web Speech API transcribes your speech in real-time.
2. **Transcript**: The transcript is sent to the server via WebSocket.
3. **Intent**: AKARI detects intent -- conversation, action, or build request.
4. **Execution**: Spawns a Claude Code subprocess or runs AppleScript for macOS apps.
5. **TTS**: Fish Audio converts the response to speech with the AKARI voice model.
6. **Visualization**: The Three.js lilac orb deforms and pulses in response to the audio frequency.

---

## Installation & Usage

For detailed step-by-step instructions, please see **[CLAUDE.md](CLAUDE.md)**.

### Prerequisites
- **macOS** (required for AppleScript integration)
- **Python 3.11+** & **Node.js 18+**
- **Anthropic API key** & **Fish Audio API key**
- **Claude Code CLI** (`npm install -g @anthropic-ai/claude-code`)

### Quick Start
```bash
# Clone the repo
git clone https://github.com/akariwill/akari.git
cd akari

# Setup environment
cp .env.example .env
# Edit .env with your keys

# Install dependencies
pip install -r requirements.txt
cd frontend && npm install && cd ..

# Generate SSL certs
openssl req -x509 -newkey rsa:2048 -keyout key.pem -out cert.pem -days 365 -nodes -subj '/CN=localhost'

# Run Backend & Frontend
# Terminal 1: python server.py
# Terminal 2: cd frontend && npm run dev
```

---

## Key Files

| File | Purpose |
|------|---------|
| `server.py` | Main server -- WebSocket handler, LLM, action system. |
| `frontend/src/orb.ts` | Three.js particle orb visualization (Lilac theme). |
| `frontend/src/voice.ts` | Web Speech API + audio playback management. |
| `actions.py` | System actions (Terminal, Chrome, Claude Code). |
| `memory.py` | SQLite memory system with FTS5 search. |
| `work_mode.py` | Persistent Claude Code development sessions. |

---

## Deployment (Online Demo)

**Demo Website**: [akari-assistant.up.railway.app](https://akari-assistant.up.railway.app/)

To host AKARI online for demo purposes (e.g., Railway, Render, or VPS):

1.  **Railway/Render**: Connect your GitHub repo.
2.  **Environment Variables**: Add `ANTHROPIC_API_KEY` and `FISH_API_KEY`.
3.  **Docker**: The provided `Dockerfile` will automatically:
    - Build the Vite frontend.
    - Set up the Python/FastAPI environment.
    - Install Playwright for web automation.
4.  **Public URL**: Ensure you access via **HTTPS** for voice features to work.

*Note: macOS-specific features (AppleScript for Calendar/Mail) only work when running locally on a Mac.*

---

## Features in Detail

### Action System
AKARI uses action tags to trigger real system actions:
- `[ACTION:BUILD]` -- spawns Claude Code to build a project.
- `[ACTION:BROWSE]` -- opens Chrome to a URL or search query.
- `[ACTION:RESEARCH]` -- deep research with Claude Opus, outputs an HTML report.
- `[ACTION:REMEMBER]` -- stores a fact for future context.

### Memory System
AKARI remembers things you tell it using SQLite with FTS5 full-text search. Preferences, decisions, and facts persist across sessions.

---

## Contributing

Contributions are welcome! Please check **[CONTRIBUTING.md](CONTRIBUTING.md)** for guidelines on adding new integrations, Windows/Linux support, or UI improvements.

---

## License

This project is licensed under the [MIT License](LICENSE).

---

## Credits & Contact

- **Author**: [akariwill](https://github.com/akariwill)
- **Discord**: `wildanjr_` | **Instagram**: `@akariwill`
- **Voice**: Powered by [Fish Audio](https://fish.audio).
- **Brain**: Powered by [Anthropic Claude](https://anthropic.com).

  Inspired by Akari Watanabe (渡辺 星) from "More Than a Married Couple, But Not Lovers".

