Skip to content

Installation

Prerequisites

  • Python 3.11+
  • Neo4j or FalkorDB database
  • OpenAI API key (or compatible LLM provider)

Install Aletheia

# Clone the repository
git clone https://github.com/david-morales/aletheia.git
cd aletheia

# Install dependencies (with dev tools for testing/linting)
pip install -e ".[dev]"

Database Setup

# Run FalkorDB with Docker
docker run -p 6379:6379 -it --rm falkordb/falkordb

Option B: Neo4j

# Run Neo4j with Docker
docker run -p 7474:7474 -p 7687:7687 \
  -e NEO4J_AUTH=neo4j/password \
  neo4j:5

Configuration

Create a .env file or set environment variables:

# Database (choose one)
ALETHEIA_DATABASE_TYPE=falkordb  # or neo4j

# FalkorDB
FALKORDB_HOST=localhost
FALKORDB_PORT=6379

# Or Neo4j
NEO4J_URI=bolt://localhost:7687
NEO4J_USERNAME=neo4j
NEO4J_PASSWORD=password

# LLM
OPENAI_API_KEY=sk-...

Verify Installation

# List available use cases
aletheia list-use-cases

# List knowledge graphs
aletheia list-graphs

Next Steps