v1claw

# V1Claw

**Your 24/7 Personal AI Assistant — Like Jarvis, but open source.**

V1Claw is a self-hosted AI assistant that runs on your Mac, Linux PC, Windows machine, or Android phone via Termux. Connect any LLM provider you want, talk to it through voice or text, and let it control your device — read files, run commands, browse the web, take photos, send messages, and more.

One binary. No required V1Claw cloud service. Your data stays on your machine unless you choose a cloud model or channel.

Default home directory: `~/.v1claw` on macOS/Linux, `%APPDATA%\\V1Claw` on Windows.
Set `V1CLAW_HOME` to override it.

---

## Features

### 🧠 15 LLM Providers
Connect to any AI model — paid APIs or self-hosted:

| Provider | Type | Models |
|----------|------|--------|
| **Anthropic** | Cloud API | Gemini 4, Claude 3.5, etc. |
| **OpenAI** | Cloud API | GPT-5, GPT-4, etc. |
| **Google Gemini** | Cloud API | Gemini 2.x, etc. |
| **Google Vertex AI** | Cloud API | Gemini on Vertex |
| **AWS Bedrock** | Cloud API | Gemini, Llama, Nova |
| **Azure OpenAI** | Cloud API | GPT deployments on Azure |
| **Groq** | Cloud API | LLaMA, Mixtral (fast inference) |
| **OpenRouter** | Cloud API | 100+ models via single API |
| **Gemini** | Cloud API | Gemini V3, Coder |
| **NVIDIA** | Cloud API | NIM models |
| **Moonshot** | Cloud API | Kimi |
| **Zhipu** | Cloud API | GLM-4 |
| **Ollama** | Local | Any GGUF model on your machine |
| **vLLM** | Local | Self-hosted inference server |
| **GitHub Copilot** | Cloud API | Via Gemini subscription |
| **Any OpenAI-compatible API** | REST API | Custom endpoints |

### 🎤 Voice I/O Pipeline
Talk to V1Claw like Jarvis:
- **Microphone recording** — continuous listening with configurable backends
- **Speech-to-Text** — powered by Groq Whisper (fast, accurate)
- **Text-to-Speech** — OpenAI TTS or Edge TTS (free)
- **Wake word detection** — "Hey V1Claw" or custom phrases
- **Push-to-talk mode** — manual recording trigger
- Works on **desktop** (a