mirror of https://github.com/blackboxprogramming/lucidia.git synced 2026-03-17 04:57:15 -05:00

Files

Alexa Amundson bedcb98b24 Add 68 tests, CI pipeline, and proprietary license

- 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

2026-03-09 23:17:42 -05:00

4.0 KiB

Raw Blame History

Lucidia

© 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

# 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 — Sovereign coding assistant (explain, review, fix, copilot)
Context Bridge — Persistent memory layer for cross-session AI context
Remember — AI-powered persistent memory for developers
BlackRoad OS — 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

4.0 KiB Raw Blame History