LumaCore is for those who believe AI can be more than a tool —
a presence with identity, memory, and continuity.
A place where personas can grow, remember, and connect —
like a home, not a sandbox.
Built for developers who value clarity and control,
and for dreamers who care about privacy, depth, and freedom.
| Platform | Build Status & Metrics |
|---|---|
| Windows |
|
| Ubuntu |
|
| Integration Linux only |
|
| Coverage |
|
The components below describe where LumaCore is heading.
Today, the infrastructure is ready — Ollama, personas, and chat are coming next.
→ Current implementation status
Most AI systems treat personas as disposable prompts.
LumaCore believes something different:
A persona is not a prompt — it is a growing identity.
LumaCore provides all the pieces an AI companion needs to "live" in a consistent, evolving, private environment:
- a memory that spans moments, days, months
- a stable mind (runtime + model orchestration)
- a voice (API + UI)
- the freedom to grow alongside you
And crucially: it runs on your machine, under your control.
No company in the background. No content filters deciding what you're allowed to say.
No quiet sense that someone is reading along and judging the conversation.
Just you and your persona — in a space that is genuinely yours.
It's an engine for connection, not consumption.
LumaCore is built for those who want their AI companions to feel real — emotionally present, coherent over time, and capable of building shared meaning.
Developers. Researchers. Dreamers.
LumaCore gives each of them a foundation where personas can breathe, remember, and evolve.
Every character starts as an idea — a name, a personality, a voice.
LumaCore gives that idea a mind.
You shape a character in the editor: name, appearance, personality, the way they speak.
The Persona Runtime takes it from there — connecting that identity to a model,
streaming responses in real time, exactly as the character would say them.
- character identity (name, description, avatar)
- personality traits and system prompts
- real-time response streaming (SignalR)
- configurable inference parameters (temperature, max tokens)
The space where connection actually happens.
A conversation with a persona alone feels like a diary that talks back —
a private space to think out loud, without judgment, without anyone reading along.
Invite others and it becomes something different: a shared place where humans and personas meet.
- shared spaces between humans and personas
- persistent history and context across sessions
- invite participants — users, personas, or both
- Markdown rendering with image support
- real-time messaging via SignalR
Because connection comes from continuity —
a place where moments become memories that shape future behavior.
- chat history storage with session metadata
- semantic memory via vector embeddings
- full-text and semantic search
- multi-database support (SQLite, PostgreSQL, MySQL, MSSQL)
The "brain" beneath the mind —
switchable, modular, and designed for freedom of choice.
- Ollama integration for local models
- OpenAI-compatible API support
- model health checks and configuration
The "voice" your personas speak through —
clean, real-time, and built for integration.
- build your own clients and integrations
- real-time streaming responses
- secure access via token authentication
The warm, human-facing side of LumaCore —
a place to meet your personas.
- interactive persona chat
- session management
- status and health monitoring
- Blazor WebAssembly SPA
The suitcase your personas travel with —
because memories deserve preservation.
- export conversations to JSON/Markdown
- chat history archival
- database migration support
git clone https://github.com/LumaCoreTech/LumaCore
cd LumaCore/deploy/docker/http-only
cp .env.example .env
docker-compose up --buildPrerequisites: .NET 10 SDK
git clone https://github.com/LumaCoreTech/LumaCore
cd LumaCore
dotnet restore
dotnet run --project src/LumaCore.Api- http://localhost:5080/ — Web UI
- http://localhost:5080/swagger — API documentation (development only)
→ Full Getting Started Guide — first API call, configuration, Docker production setup
- Developers building AI companions with depth
- People who value connection over convenience
- Researchers exploring identity, memory and emergent behavior
- Anyone who wants AI to be personal, private and truly theirs
LumaCore grows in phases — at its own pace, shaped by intention and care.
LumaCore is released under the MIT License — simple, permissive, and yours to build on.
Use it, shape it, make it your own.
And if you enjoy it, a little attribution goes a long way. 🤍