https://github.com/CloudToLocalLLM-online/CloudToLocalLLM
Privacy-first desktop AI companion with 5 pillars: unified chat, OpenClaw Gateway, evolving avatar, desktop control, and vision. Auth0 with encrypted tunneling.
https://github.com/CloudToLocalLLM-online/CloudToLocalLLM
ai chatbot localllama localllm ollama-api
Last synced: 23 days ago
JSON representation
Privacy-first desktop AI companion with 5 pillars: unified chat, OpenClaw Gateway, evolving avatar, desktop control, and vision. Auth0 with encrypted tunneling.
- Host: GitHub
- URL: https://github.com/CloudToLocalLLM-online/CloudToLocalLLM
- Owner: CloudToLocalLLM-online
- License: other
- Created: 2025-04-20T00:51:12.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2026-06-05T00:05:47.000Z (26 days ago)
- Last Synced: 2026-06-05T00:14:58.805Z (26 days ago)
- Topics: ai, chatbot, localllama, localllm, ollama-api
- Language: Dart
- Homepage: https://cloudtolocalllm.online
- Size: 1.77 GB
- Stars: 23
- Watchers: 1
- Forks: 4
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Governance: docs/governance/legal/PRIVACY.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# CloudToLocalLLM 🦞
**A local-first companion and desktop capability layer for your AI agent. Private, secure, yours.**
Your AI runs on your hardware. The app gives it voice, vision, desktop control, and a secure channel across all your devices — no data leaves your network unless you decide otherwise.
---
## Try It Now
🌐 **[cloudtolocalllm.online](https://cloudtolocalllm.online)** — Web app, works in any browser. Log in, that's it.
🐧 **Linux** — `curl -fsSL https://cloudtolocalllm.online/install.sh | bash` (coming soon)
📱 **Android** — APK builds from CI. Grab the latest from [Releases](https://github.com/CloudToLocalLLM-online/CloudToLocalLLM/releases/latest).
**You need an agent runtime.** Hermes is the primary test path. OpenClaw and compatible agent gateways also work.
---
## What Sets It Apart
| Layer | What it gives you |
|-------|-------------------|
| **Secure Channel** | Direct line to your agent, synced across devices |
| **Voice + Avatar** | Sidecar companion with personality, memory, natural conversation |
| **Desktop Control** | Permissioned access to apps, windows, keyboard, files |
| **Vision** | Screen awareness, OCR, camera — explicit per-action consent |
| **Device Mesh** | Tailscale-first private network across all your machines |
| **Runtime Manager** | Manage agents, skills, sessions, tools, diagnostics |
---
## Architecture
```
┌────────────────────────────────────────────────────────┐
│ CloudToLocalLLM App │
│ ┌──────────┐ ┌──────────┐ ┌────────────────────┐ │
│ │ Agent │ │ Avatar │ │ Desktop Control │ │
│ │ Channel │ │ Voice │ │ Vision │ │
│ └────┬─────┘ └────┬─────┘ └───────┬────────────┘ │
│ └──────────────┼────────────────┘ │
│ ▼ │
│ ┌──────────────────────┐ │
│ │ Agent Adapter │ │
│ │ Hermes / OpenClaw │ │
│ └──────────┬──────────┘ │
└──────────────────────┼───────────────────────────────────┘
│
┌────────┴────────┐
│ │
┌────▼────┐ ┌─────▼──────┐
│ Local │ │ Model │
│ Agent │ │ Providers │
│ Runtime│ │ (Ollama, │
│ │ │ LM Studio)│
└─────────┘ └────────────┘
```
Technical deep-dive → [System Architecture](docs/architecture/SYSTEM_ARCHITECTURE.md)
---
## Platforms
| Platform | Status |
|----------|--------|
| 🐧 Linux | ✅ AppImage + auto-update daemon |
| 🌐 Web | [cloudtolocalllm.online](https://cloudtolocalllm.online) |
| 📱 Android | ✅ APK builds from CI |
| 🪟 Windows | 🚧 Installer in development |
| 🍎 macOS | 📋 Planned |
---
## Development
```bash
git clone https://github.com/CloudToLocalLLM-online/CloudToLocalLLM.git
cd CloudToLocalLLM
flutter pub get
# Run
flutter run -d linux # Desktop
flutter run -d chrome # Web
```
```bash
# Build
flutter build linux --release
flutter build web --release
flutter build apk --release --split-per-abi
```
### Backend Services
```bash
cd services/api-backend && npm install && npm run dev
cd services/streaming-proxy && npm install && npm run dev
```
Full developer guide → [docs/development/BUILD_SCRIPTS.md](docs/development/BUILD_SCRIPTS.md)
---
## Documentation
📖 [docs.cloudtolocalllm.online](https://docs.cloudtolocalllm.online)
| Guide | What's in it |
|-------|-------------|
| [User Guide](docs/user-guide/USER_GUIDE.md) | Features and usage |
| [Setup Guide](docs/user-guide/SETUP_GUIDE.md) | Step-by-step installation |
| [Troubleshooting](docs/user-guide/TROUBLESHOOTING.md) | Common issues |
| [System Architecture](docs/architecture/SYSTEM_ARCHITECTURE.md) | Technical deep-dive |
| [Deployment Guide](docs/operations/backend/) | Production setup |
| [Security Guide](docs/operations/security/SECURITY.md) | |
---
## License
MIT — see [LICENSE](LICENSE).