Klaudimero

Klaudimero

A self-hosted AI assistant service with native iOS/macOS and Android apps, powered by [Claude Code](https://claude.ai/code) — with optional [opencode](https://opencode.ai), [Pi](https://pi.dev/), and Codex CLI support as alternative engines. Chat via streaming conversations, schedule recurring jobs, run a background heartbeat agent, get text-to-speech readback, and monitor everything through home screen widgets and push notifications.

Architecture

• Backend: Python/FastAPI with APScheduler, JSON file storage
• iOS/macOS App: SwiftUI app for managing jobs, chatting, and viewing execution logs
• Android App: Jetpack Compose (Material 3) app with chat, jobs, heartbeat, and voice input
• Notifications: APNs push notifications on job events
• Widget: Home screen widget showing live status

                                      +------------------------+
+-------------+       REST API        |   FastAPI Backend       |
|  iOS/macOS  | <--------------------> |                        |
|     App     |                       |  APScheduler            |
|  (SwiftUI)  | <-- APNs push ------- |  Engine executor        |
|             |                       | (claude/opencode/pi/    |
|             |                       |  codex)                 |
+-------------+                       |  Chat sessions          |
                                      |  Heartbeat agent        |
+-------------+       REST API        |  Edge TTS               |
|   Android   | <--------------------> |  JSON file storage      |
| (Compose)   |                       +------------------------+
+-------------+
+-------------+
|   Widget    | <-- App Group cache --+
+-------------+

Prerequisites (Ubuntu, without Docker)

Install system packages:

sudo apt-get update && sudo apt-get install -y \
    python3 python3-venv python3-pip \
    curl git build-essential jq wget unzip

Install Node.js 22 (required for the `claude` CLI):

cur