Back to directory

OpenLumara

A modular, token-efficient AI agent framework, written from scratch in Python, built for local models with a small system prompt and hard, code-enforced limits on what the AI can do, rather than relying on prompt engineering for safety.

OpenLumara

OpenLumara keeps its system prompt as small as around 4,000 tokens in normal use, which keeps token usage down both with local models served through llama.cpp or koboldcpp and with public model APIs. Every component beyond the minimal core, including shell access, memory, the scheduler, time-awareness and token-awareness, is a module that can be turned on or off with a /module command, down to an empty system prompt that talks to the base model directly.

It connects to any OpenAI API-compatible backend, local or cloud, and can be self-hosted for full privacy or run on a cloud server. It ships interfaces for a browser-based WebUI, a terminal CLI, Telegram, Discord and Matrix (with encryption support), with more planned.

The project's core framework was designed and hand-coded by its author, who used AI only to ask how to fix bugs or accomplish specific things in Python, auditing and modifying anything AI-assisted before it went in; some non-core channel integrations were mostly AI-generated and then manually audited.

More in Agent frameworks

See all 902
  • Recurse

    recurse.run

    A serverless harness that lets a coding agent design, test, and deploy its own specialist sub-agents as tools, MCP servers, or bots, defined by a schema-validated manifest.

  • ProofForge

    shulgin.is-a.dev

    An AI-agent pipeline that decomposes a mathematics problem, proves each piece, and formalizes the result in Lean 4 and Mathlib until the Lean kernel accepts it, with six of its proofs already merged into Google DeepMind's formal-conjectures repository.

  • local-coder

    github.com

    Builds a local coding-agent team on top of Ollama and OpenCode by detecting the machine's hardware, recommending models for seven specialist roles, and testing whether each assigned model can actually use tools, edit a repository and pass verification.