WiseClaw

WiseClaw is a local-first personal assistant for macOS. It runs a FastAPI backend, uses Ollama for local LLM access, exposes a Telegram bot, and includes a React admin panel for settings, logs, and memory management.

Planned capabilities

Telegram chat with whitelist support
Local Ollama integration for qwen3.5:4b
Brave or SearXNG-backed web search
Apple Notes integration via AppleScript
File read/write tools
Terminal execution with policy modes
SQLite-backed memory, settings, and audit logs
macOS Keychain for secrets

Repository layout

backend/ FastAPI app and WiseClaw core modules
frontend/ React admin panel
docs/ architecture and rollout notes

Local development

Backend

cd backend
python3.12 -m venv .venv312
source .venv312/bin/activate
pip install .
uvicorn app.main:app --reload

Frontend

cd frontend
npm install
npm run dev

Smoke checks

cd backend
source .venv312/bin/activate
uvicorn app.main:app --reload

Then in another shell:

curl http://127.0.0.1:8000/health
curl http://127.0.0.1:8000/bootstrap
curl http://127.0.0.1:8000/admin/integrations/ollama
curl http://127.0.0.1:8000/admin/integrations/telegram

Environment bootstrap

Copy .env.example to .env and fill in only the values you need for the first boot. Secrets that are changed from the admin panel should be written to Keychain, not back to .env.

1.4 KiB Raw Permalink Blame History