Quick Start

This guide shows the fastest way to explore Pohualli.

1. Install

Choose one:

PyPI (CLI & library):

pip install pohualli

Desktop app (macOS / Windows): download bundle artifact from a Release (no Python needed). First macOS run: Control-click -> Open. From source (dev):

pip install -e .[dev,docs]

2. CLI

pohualli from-jdn 2451545 --json
pohualli search-range 584283 584400 --tzolkin-value 4 --limit 2  # range scan example

3. Python

from pohualli import compute_composite
print(compute_composite(2451545).tzolkin_name)

4. RPC Backend (for Flutter)

pohualli-rpc

5. Flutter Desktop UI

cd flutter/pohualli_desktop
flutter pub get
flutter run -d macos
# or: flutter run -d windows

6. Configuration

Adjust New Era or year bearer reference via query params or CLI flags.