mirror of
https://github.com/blackboxprogramming/lucidia.git
synced 2026-03-17 03:57:13 -05:00
Alexa Amundson
bedcb98b24
- 21 tests for LucidiaAI (sentiment, response, memory persistence) - 40 tests for lucidia_logic (Trinary, psi_prime, breath functions, all symbolic math) - 7 tests for substrate_performance_optimizer - GitHub Actions CI with Python 3.10/3.11/3.12 matrix - Replace MIT license with BlackRoad OS proprietary - Add CI badge and Python badge to README Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> RoadChain-SHA2048: 7ecced90454ac8af RoadChain-Identity: alexa@sovereign RoadChain-Full: 7ecced90454ac8af8796eba2e76e1c5a6325fe9f492446eb54b56c4967b8955222421e5b00932b26094a72046729c7d82ed51c60c71c2c47eec4215b89f18db8c4ec918630872f503511798b6233c352deb7caff00c3abf9d73939562db633a6ea4e47c46b3ff3be3822a8d94168be530ee2d3817a9f579b83bce735d43e1f579c7a5eae728824163cb4443ad00a93881c1915c87111c9ca130ae4f196a47ed68707b1ea4cab0d995ea546544cc83120a260f2e4f409b2a9d8a12603d0b4556c389caf25c906e58b982ff300dcc8a8425cc5f1e1e640c96602dd3ed5c88131f5fc790aa4a721d89a079db244a1c57297a4d56e9dbde75a8fc25539e15560213c
97 lines
4.0 KiB
Markdown
97 lines
4.0 KiB
Markdown
# Lucidia
|
|
|
|
[](https://github.com/blackboxprogramming/lucidia/actions/workflows/ci.yml)
|
|
[](https://www.python.org/)
|
|
|
|
> **© BlackRoad OS, Inc. — Proprietary. All rights reserved.**
|
|
|
|
**The AI that remembers you.**
|
|
|
|
Lucidia is a conversational AI platform with persistent memory, multi-service orchestration, and a sovereign-first architecture. Built on FastAPI, it runs on your hardware — no cloud dependency, no data siphon.
|
|
|
|
## What It Does
|
|
|
|
- **Persistent Memory** — SQLite-backed key-value memory that persists across sessions. Every conversation builds on the last.
|
|
- **Agent System** — Chat with Lucidia, or call tools directly. Slack, Asana, Linear, Notion, GitHub, Jira — all accessible through a unified agent interface.
|
|
- **Local AI Completion** — Connect to any local LLM (llama.cpp, Ollama) for sovereign AI inference with zero external API calls.
|
|
- **Provider Registry** — Feature-flagged integrations. Enable services by setting environment variables — no code changes needed.
|
|
- **Health Monitoring** — Built-in health checks for fleet deployment across Raspberry Pi clusters.
|
|
|
|
## Architecture
|
|
|
|
```
|
|
┌─────────────────────────────────────────┐
|
|
│ FastAPI Server │
|
|
├──────────┬──────────┬───────────────────┤
|
|
│ Memory │ Agent │ Completions │
|
|
│ SQLite │ Router │ Local LLM │
|
|
├──────────┴──────────┴───────────────────┤
|
|
│ Provider Registry │
|
|
│ Slack · Asana · Linear · Notion · ... │
|
|
└─────────────────────────────────────────┘
|
|
```
|
|
|
|
## Quickstart
|
|
|
|
```bash
|
|
# Clone
|
|
git clone https://github.com/blackboxprogramming/lucidia.git
|
|
cd lucidia
|
|
|
|
# Install
|
|
pip install fastapi pydantic uvicorn
|
|
|
|
# Configure integrations (optional)
|
|
export SLACK_BOT_TOKEN=xoxb-...
|
|
export LINEAR_API_KEY=lin_...
|
|
export GITHUB_TOKEN=ghp_...
|
|
|
|
# Run
|
|
uvicorn main:app --host 0.0.0.0 --port 8000
|
|
```
|
|
|
|
## API
|
|
|
|
| Endpoint | Method | Description |
|
|
|----------|--------|-------------|
|
|
| `/` | GET | Status check |
|
|
| `/healthz` | GET | Health probe |
|
|
| `/memory/put` | POST | Store a memory `{key, value}` |
|
|
| `/memory/get?key=` | GET | Retrieve a memory by key |
|
|
| `/agent/capabilities` | GET | List enabled integrations |
|
|
| `/agent/chat` | POST | Chat or call a tool `{message, tool, args}` |
|
|
| `/agent/complete` | POST | Local LLM completion `{prompt, max_tokens}` |
|
|
| `/slack/say` | POST | Send a Slack message |
|
|
| `/asana/me` | GET | Asana user info |
|
|
| `/linear/me` | GET | Linear user info |
|
|
|
|
## Environment Variables
|
|
|
|
| Variable | Service |
|
|
|----------|---------|
|
|
| `SLACK_BOT_TOKEN` | Slack |
|
|
| `ASANA_ACCESS_TOKEN` | Asana |
|
|
| `LINEAR_API_KEY` | Linear |
|
|
| `NOTION_TOKEN` | Notion |
|
|
| `GITHUB_TOKEN` | GitHub |
|
|
| `JIRA_URL` + `JIRA_EMAIL` + `JIRA_API_TOKEN` | Jira |
|
|
|
|
## Ecosystem
|
|
|
|
- **[Lucidia CLI](https://github.com/blackboxprogramming/lucidia-cli)** — Sovereign coding assistant (explain, review, fix, copilot)
|
|
- **[Context Bridge](https://github.com/blackboxprogramming/context-bridge)** — Persistent memory layer for cross-session AI context
|
|
- **[Remember](https://github.com/blackboxprogramming/remember)** — AI-powered persistent memory for developers
|
|
- **[BlackRoad OS](https://github.com/blackboxprogramming/BlackRoad-Operating-System)** — The operating system for governed AI
|
|
|
|
## Infrastructure
|
|
|
|
Lucidia runs on the BlackRoad sovereign computing fleet:
|
|
- 5 Raspberry Pi 5 nodes (WireGuard mesh)
|
|
- 52 TOPS AI acceleration (2x Hailo-8)
|
|
- 108 local models via Ollama
|
|
- Zero cloud dependencies
|
|
|
|
## License
|
|
|
|
Copyright 2026 BlackRoad OS, Inc. — Alexa Amundson. All rights reserved.
|