62 lines
1.4 KiB
Markdown
62 lines
1.4 KiB
Markdown
# 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`.
|