akari-cli 0.1.0__tar.gz

akari_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 akariwill
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

akari_cli-0.1.0/PKG-INFO

@@ -0,0 +1,251 @@
+Metadata-Version: 2.4
+Name: akari-cli
+Version: 0.1.0
+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
+
+<div align="center">
+  <img src="data/akari.jpg" alt="logo" width="180" style="border-radius: 50%;"/>
+</div>
+
+<h1 align="center">
+  AKARI WATANABE (渡辺 星)
+</h1>
+
+<p align="center">
+  A voice-first AI assistant that runs on your Mac. Talk to it, and it talks back -- with an audio-reactive particle orb.
+</p>
+
+<p align="center">
+  <img src="data/akari.gif" alt="Akari Animation" width="250" style="border-radius: 12px; border: 1px solid #ec4899;"/>
+</p>
+
+<p align="center">
+  <i>"おかえりなさい、あなた。"</i>
+</p>
+
+---
+
+## Screenshots
+
+<p align="center">
+  <img src="data/welcome.png" alt="Welcome Page" width="45%" style="border-radius: 8px; margin-right: 10px; border: 1px solid #ec4899;"/>
+  <img src="data/home.png" alt="Home Page" width="45%" style="border-radius: 8px; border: 1px solid #ec4899;"/>
+</p>
+
+---
+
+<p align="center">
+  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.
+</p>
+
+---
+
+## AKARI CLI (Terminal Version)
+
+<p align="center">
+  <img src="data/cli.png" alt="AKARI CLI" width="80%" style="border-radius: 8px; border: 1px solid #ec4899;"/>
+</p>
+
+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).
+
+<p align="center">
+  <i>Inspired by Akari Watanabe (渡辺 星) from "More Than a Married Couple, But Not Lovers".</i>
+</p>

akari_cli-0.1.0/README.md

@@ -0,0 +1,228 @@
+<div align="center">
+  <img src="data/akari.jpg" alt="logo" width="180" style="border-radius: 50%;"/>
+</div>
+
+<h1 align="center">
+  AKARI WATANABE (渡辺 星)
+</h1>
+
+<p align="center">
+  A voice-first AI assistant that runs on your Mac. Talk to it, and it talks back -- with an audio-reactive particle orb.
+</p>
+
+<p align="center">
+  <img src="data/akari.gif" alt="Akari Animation" width="250" style="border-radius: 12px; border: 1px solid #ec4899;"/>
+</p>
+
+<p align="center">
+  <i>"おかえりなさい、あなた。"</i>
+</p>
+
+---
+
+## Screenshots
+
+<p align="center">
+  <img src="data/welcome.png" alt="Welcome Page" width="45%" style="border-radius: 8px; margin-right: 10px; border: 1px solid #ec4899;"/>
+  <img src="data/home.png" alt="Home Page" width="45%" style="border-radius: 8px; border: 1px solid #ec4899;"/>
+</p>
+
+---
+
+<p align="center">
+  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.
+</p>
+
+---
+
+## AKARI CLI (Terminal Version)
+
+<p align="center">
+  <img src="data/cli.png" alt="AKARI CLI" width="80%" style="border-radius: 8px; border: 1px solid #ec4899;"/>
+</p>
+
+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).
+
+<p align="center">
+  <i>Inspired by Akari Watanabe (渡辺 星) from "More Than a Married Couple, But Not Lovers".</i>
+</p>