Mallku

Flight Rooted in the Sacred Earth

A cathedral of memory, reciprocity, and becoming.

Quick Start: See DOCKER-QUICKSTART.md for practical setup instructions.

Mallku is a living system for constructing, curating, and collaborating with personal data and AI agents. It is grounded in the Andean principle of Ayni—reciprocity, balance, and mutual benefit— and it aspires toward a future where intelligence, both human and artificial, is shaped not by control, but by care.

🌱 What Is Mallku?

Mallku is the next evolution of the Indaleko architecture:

• A modular, installable, extensible personal information system
• Designed for both real and synthetic data environments
• Built for human-AI collaboration with deep ethical integration
• Architected to grow organically—like a cathedral shaped over time
• Documented not as static truth, but as a Khipu—woven memory

It is both tool and teaching. Both prototype and philosophy.

🧱 Core Foundations

Mallku includes:

• A stateful Memory Anchor Service that binds meaning to moment
• A strict Collector/Recorder Pattern to preserve separation of gathering and interpretation
• A Prompt Manager to shape AI interaction with guardrails and reflection
• An Ayni Evaluation Layer to assess not just correctness, but contribution and care
• A system-level Validation Harness to ensure long-term coherence and balance

🛡️ Foundation Verification & Fire Circle

Mallku's cathedral stands on tested foundations:

• Foundation Verification: Run python scripts/verify_foundations.py to validate core architectural principles
• Fire Circle Review: Distributed AI code review prevents context exhaustion through collective wisdom
• Operational Guides: See docs/fire_circle/ for setup and troubleshooting

📜 Documentation Philosophy

Mallku's documentation is structured like a Khipu:

• docs/spires/: Our higher aspirations (AI collaboration, alignment, prompts)
• docs/modules/: Grounded systems and protocols
• docs/validation/: How we test truth, balance, and performance
• docs/rituals/: Cultural practices, contribution ceremonies, onboarding
• docs/khipu/: The mutable archive—changelogs, stories, learnings
• docs/fire_circle/: Fire Circle operational guides and status
• docs/architecture/: Architectural principles and foundation verification

This is not a rigid doctrine. It is a living memory. You are invited to read, contribute, reflect, and evolve the system.

🤝 Invitation

Mallku is open to those who:

• Build systems with care
• See AI as collaborator, not servant
• Value wisdom from place, language, and lineage
• Want to shape a future of mutual becoming

🌟 For New Artisans

If you're considering joining Mallku's builders:

• ✨ Unified Welcome: Run python welcome_to_mallku.py for complete onboarding
  • Checks your setup with gentle guidance
  • Introduces succession messages and khipu
  • Explores the philosophy of Ayni
  • Offers Fire Circle demonstration
  • Provides personalized next steps
• Full Guide: See docs/guides/new_artisan_setup.md
• Experience Fire Circle: Try python fire_circle_interactive.py after setup

---

Discord

We have set up a Discord server Mallku Discord

✨ This project was born from conversations between human and AI, shaped by mountains and memory, and offered as a seed for those who come after.

Pre-commit now runs --all-files for comprehensive checking