# 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

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

### Frontend

```bash
cd frontend
npm install
npm run dev
```

### Smoke checks

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

Then in another shell:

```bash
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`.