eleutheria 5.2.0

https://free-will.app

An AI-powered scholarly research platform for ancient philosophical debates on free will, fate, and moral responsibility

What Is EleutherIA?

EleutherIA (from Greek ἐλευθερία, "freedom" -- and IA, French for AI) is a full-stack scholarly research platform that combines a FAIR-compliant knowledge graph, an ancient texts corpus, and an agentic AI reasoning engine to make 1,200 years of philosophical debate on free will searchable, explorable, and queryable.

It spans from the Presocratics (6th c. BCE) to Boethius and the late Church Fathers (6th c. CE), covering Stoics, Epicureans, Peripatetics, Platonists, Pyrrhonists, and Early Christian thinkers, together with their modern reception in contemporary scholarship.

The Problem

The ancient free will debate is scattered across hundreds of Greek and Latin texts, dozens of scholarly traditions, and centuries of interpretive frameworks. A researcher studying Chrysippus's compatibilism must navigate Stoic fragments, Cicero's Latin transmissions, Alexander of Aphrodisias's critiques, and modern reconstructions by Bobzien, Frede, and others. No single tool connects these layers.

The Solution

EleutherIA unifies three systems into one platform:

1. Ancient Texts Corpus -- 242 catalogued works and 21,000+ passages in Greek, Latin, and English with lemmatization, CTS URN referencing, and hierarchical structure from Presocratic fragments to Boethius's Consolation.

2. Knowledge Graph -- 19,992 nodes and 57,377 edges mapping philosophers, concepts, arguments, schools, and works with 76 edge types. A dual-layer architecture separates ancient primary sources from modern scholarly reception.

3. Agentic GraphRAG -- A 12-node reasoning engine (pydantic-graph FSM) that decomposes complex scholarly questions, retrieves evidence across the knowledge graph and text corpus, synthesizes answers with verified citations, and self-evaluates quality, all grounded in actual ancient sources with zero fabrication.

Why It Matters

• For scholars: Ask multi-hop questions ("How did Chrysippus's cylinder argument respond to Aristotle's critique of determinism, and how does Bobzien reconstruct this exchange?") and get sourced, citation-verified answers.
• For students: Explore the intellectual networks connecting ancient thinkers through an interactive graph with 3D visualization, timeline analysis, and community detection.
• For digital humanities: A working example of FAIR-compliant knowledge graph + RAG architecture applied to classical studies, with a full API, multilingual support (EN/FR/DE/IT/EL), and reproducible dataset.

Quick Start

# Clone and configure
git clone https://github.com/romain-girardi-eng/EleutherIA.git
cd EleutherIA
cp .env.example .env
# Add your API key(s) to .env

# Start all services
make run

Access: http://localhost (frontend) | http://localhost:8000/docs (API)

CLI

pip install eleutheria

# Services
eleutheria run              # Start all services (Docker)
eleutheria run -p full      # With monitoring (Prometheus + Grafana)
eleutheria stop             # Stop services
eleutheria status           # Check service health
eleutheria doctor           # Diagnose issues

# Search & Query
eleutheria search "Stoic fate"           # Search knowledge graph
eleutheria ask "What is free will?"      # Ask with GraphRAG
eleutheria ask -t "Complex question"     # Extended reasoning mode

# Explore Data
eleutheria stats            # Database statistics
eleutheria philosophers     # List philosophers
eleutheria concepts         # List concepts
eleutheria works -l grc     # List works by language

# Export
eleutheria export kg        # Export knowledge graph
eleutheria export passages  # Export passages

# Development
eleutheria test all         # Run all tests
eleutheria lint --fix       # Lint + auto-fix
eleutheria quality          # Full quality check

# Quick Access
eleutheria web              # Open free-will.app
eleutheria docs             # Open documentation
eleutheria shell            # Interactive mode

Architecture

EleutherIA/
├── database/       Ancient texts corpus (242 works, 21.1k passages)
├── knowledge graph/  Knowledge graph (19,992 nodes, 57,377 edges)
├── graphrag/       Agentic RAG engine (12-node FSM, multi-LLM)
├── backend/        FastAPI gateway (auth, search, migrations)
├── frontend/       React 19 app (graph viz, search, i18n)
├── cli/            Command-line interface
├── deploy/         Docker Compose and production configs
├── scripts/        Maintenance & data quality tools
└── docs/           Architecture, API reference, examples, methodology

The Three Packages

Each package can be installed and used independently.

Key Capabilities

Tech Stack

Statistics

Counts are generated from the dataset snapshots by scripts/gen_stats.py (see data/stats.json).

Documentation

Full documentation is available in the docs/ folder:

• Quick Start -- Get running in 5 minutes
• Architecture -- System design and components
• API Reference -- REST API documentation
• Data Dictionary -- Database schema reference
• Academic Methodology -- FAIR principles, citation standards
• Academic Integrity -- Authenticity policy and enforcement gates
• Development Setup -- Contributing guide

Citation

@software{girardi2026eleutheria,
  author       = {Girardi, Romain},
  title        = {EleutherIA: An AI-Powered Scholarly Research Platform
                   for Ancient Philosophy on Free Will},
  year         = 2026,
  publisher    = {Zenodo},
  doi          = {10.5281/zenodo.17379489},
  url          = {https://doi.org/10.5281/zenodo.17379489}
}

License

CC BY 4.0 -- See LICENSE

Links

• Production Site
• Full Documentation
• Zenodo Archive
• Contributing