isiLimela — the Zulu name for the Pleiades, the constellation that signals the time of planting and renewal in Bantu cultures.

Limela finds the constellations in your emails, bringing order to your world.

Limela is an email intelligence pipeline that transforms your chaotic inbox into a structured knowledge graph. It reads your emails, understands their meaning, discovers patterns and conversations, and helps you see the bigger picture — the constellations hidden in your daily communication.

Think of it as an astronomer for your inbox: while you see individual stars (emails), Limela reveals the constellations (topics, threads, relationships) that connect them.

Limela is in active development. We have comprehensive architectural plans and are building the foundation. Check out docs/roadmap.md to see where we're headed.

Limela processes emails through a sophisticated pipeline:

1. Normalization — Parse MIME structures, extract headers, handle attachments
2. Purification — Convert HTML to clean text, remove noise (signatures, disclaimers, reply chains)
3. Meta-Embedding — Generate semantic representations using transformer models (SBERT + ColBERT)
4. Clustering — Discover thematic groups and conversation threads automatically using density-based clustering
5. Knowledge Graph — Build a queryable graph of people, topics, threads, and their relationships

The result? Your emails become a navigable constellation map, with patterns and connections revealed.

• High-performance processing — Built in Rust for speed and reliability
• Privacy by design — Knowledge graph will store only metadata and encrypted pointers; email bodies remain in your mail store
• IMAP integration — Tag emails in your existing mail client based on discovered clusters
• Semantic search — Find emails by meaning, not just keywords
• Conversation threading — Automatic discovery of related emails across time and topics
• Streaming updates — Real-time processing as new emails arrive

Note: Limela is in early development. These are architectural goals, not yet implemented features.

Limela requires Rust (Edition 2024) and uses a strict code quality standard.

• Rust toolchain 1.85+ (MSRV: 1.85)
• Make (for convenience commands)

# Build the project
make build

# Run tests
make test

# Check code quality
make lint

# Format code
make fmt

For detailed development guidelines and coding standards, see the documentation in the docs/ directory.

Limela is built on powerful foundations:

• Chutoro — Our FISHDBC (Flexible, Incremental, Scalable, Hierarchical Density-Based Clustering) implementation that forms the core clustering engine of Limela
• Telephone — Our GPU-accelerated neurosymbolic reasoning playground for large language models that will power Limela's intelligence

• Roadmap — Development phases and current status
• Pipeline Design — Comprehensive architectural documentation
• ADR-001 — Knowledge graph implementation decision
• Testing Guide — Testing strategies and patterns
• Documentation Style Guide — Writing standards for docs

Email is one of our most valuable knowledge sources, but it's trapped in chronological chaos. We scan the same threads repeatedly, lose track of important conversations, and struggle to see patterns across time.

Limela brings the power of modern NLP, graph theory, and clustering algorithms to your inbox — helping you work with your email as a knowledge base, not a to-do list.

The constellations have always been there. Limela helps you see them.

ISC Licence — See LICENSE for details.

df12 Productions ✨

"In the same way the Pleiades signal a time of renewal and growth, Limela brings new understanding to your communication."