Installation
Requirements
- Python 3.12+ — aletheca uses modern type syntax (
X | Yunions, generic type params) that requires 3.12 or newer. - pip or uv package manager.
Install
=== "pip"
```bash
pip install aletheca
```
=== "uv"
```bash
uv add aletheca
```
=== "pipx (for scripts)"
```bash
pipx install aletheca
```
Verify installation
import aletheca
print(aletheca.__version__)
Optional dependencies
Aletheca keeps its core dependency footprint small (bibliofabric + pydantic). Additional analysis packages are available as an extra:
pip install "aletheca[analysis]"
This pulls in:
| Package | Purpose |
|---|---|
polars |
Fast DataFrames |
duckdb |
In-process analytical database |
pandas |
Traditional DataFrames |
numpy |
Numerical computing |
matplotlib |
Plotting |
pyarrow |
Columnar data interchange |
rich |
Terminal formatting |
??? note "Why an extra, not separate packages?"
Analysis workflows are common enough to bundle, but not everyone needs a full data science stack. The [analysis] extra lets you opt in without pulling hundreds of megabytes into lightweight deployment environments.
From source
git clone https://github.com/utsmok/aletheca.git
cd aletheca
See Contributing for the full development setup.