Part of BlackRoad OS — Sovereign Computing for Everyone
lucidia core is part of the BlackRoad OS ecosystem — a sovereign, distributed operating system built on edge computing, local AI, and mesh networking by BlackRoad OS, Inc.
| Org | Focus |
|---|---|
| BlackRoad OS | Core platform |
| BlackRoad OS, Inc. | Corporate |
| BlackRoad AI | AI/ML |
| BlackRoad Hardware | Edge hardware |
| BlackRoad Security | Cybersecurity |
| BlackRoad Quantum | Quantum computing |
| BlackRoad Agents | AI agents |
| BlackRoad Network | Mesh networking |
Website: blackroad.io | Chat: chat.blackroad.io | Search: search.blackroad.io
AI reasoning engines for specialized domains - physics, mathematics, chemistry, geology, and more.
pip install lucidia-coreLucidia is a collection of specialized AI reasoning agents, each modeled after a domain expert:
| Agent | Domain | Capabilities |
|---|---|---|
| Physicist | Physics | Energy modeling, force calculations, feedback systems |
| Mathematician | Mathematics | Symbolic computation, proofs, numerical analysis |
| Chemist | Chemistry | Molecular analysis, reactions, compound properties |
| Geologist | Geology | Terrain modeling, stratigraphy, resource mapping |
| Analyst | Data Science | Pattern recognition, insights, statistical analysis |
| Architect | Systems | Design blueprints, architecture planning |
| Engineer | Engineering | Structural analysis, calculations, optimization |
| Painter | Visual | Graphics generation, artistic rendering |
| Poet | Creative | Poetry, lyrical composition, narrative |
| Speaker | NLP | Speech synthesis, communication, translation |
# List available agents
lucidia list
# Run the physicist agent
lucidia run physicist --query "Model energy flow in a thermal system"
# Start the API server
lucidia api --port 8000# Start the server
lucidia-api
# Or with Python
python -m lucidia_core.apiThen query the agents:
# Check health
curl http://localhost:8000/health
# Physicist analysis
curl -X POST http://localhost:8000/physicist/analyze \
-H "Content-Type: application/json" \
-d '{"query": "Calculate the energy required to heat 1kg of water from 20C to 100C"}'
# Mathematician computation
curl -X POST http://localhost:8000/mathematician/compute \
-H "Content-Type: application/json" \
-d '{"query": "Solve x^2 - 5x + 6 = 0"}'from lucidia_core import get_physicist, get_mathematician
# Load the physicist
PhysicistSeed, load_seed = get_physicist()
seed = load_seed("codex21.yaml")
# Load the mathematician
MathematicianSeed, load_seed = get_mathematician()| Endpoint | Method | Description |
|---|---|---|
/health |
GET | Health check and agent list |
/physicist/analyze |
POST | Physics analysis |
/physicist/energy-flow |
POST | Energy flow modeling |
/mathematician/compute |
POST | Mathematical computation |
/mathematician/prove |
POST | Proof assistance |
/chemist/analyze |
POST | Chemical analysis |
/geologist/terrain |
POST | Terrain analysis |
/analyst/insights |
POST | Data insights |
/architect/design |
POST | System design |
lucidia-core/
├── lucidia_core/ # Package module
│ ├── api.py # FastAPI endpoints
│ └── cli.py # CLI entry point
├── physicist.py # Physics reasoning engine (867 lines)
├── mathematician.py # Math reasoning engine (760 lines)
├── chemist.py # Chemistry engine (569 lines)
├── geologist.py # Geology engine (654 lines)
├── analyst.py # Data analysis (505 lines)
├── architect.py # System design (392 lines)
├── engineer.py # Engineering (599 lines)
├── painter.py # Visual generation (583 lines)
├── poet.py # Creative text (250 lines)
├── speaker.py # Speech/NLP (302 lines)
├── codex*.yaml # Agent seed configurations
└── quantum_engine/ # Quantum computing extensions
Each agent is configured via a YAML "seed" file (e.g., codex21.yaml for Physicist):
system_charter:
agent_name: "Physicist"
generation: "2024"
domain: ["physics", "energy", "dynamics"]
moral_constant: "preserve momentum gently"
core_principle: "ground every run on measured observations"MIT - See LICENSE for details.
Built by BlackRoad OS
Copyright © 2026 BlackRoad OS, Inc. All Rights Reserved.
CEO: Alexa Amundson | PROPRIETARY AND CONFIDENTIAL
This software is NOT for commercial resale. Testing purposes only.
- 30,000 AI Agents
- 30,000 Human Employees
- CEO: Alexa Amundson
Contact: blackroad.systems@gmail.com
See LICENSE for complete terms.