Skip to content

Installation

Astronomo requires Python 3.10 or later.

uv is a fast Python package manager. Install Astronomo as a tool:

uv tool install astronomo

Or add it to an existing project:

uv add astronomo

Using pip

Install from PyPI:

pip install astronomo

From Source

Clone the repository and install with uv:

git clone https://github.com/alanbato/astronomo.git
cd astronomo
uv sync

Run the development version:

uv run astronomo

Verifying Installation

After installation, verify that Astronomo is working:

astronomo --version

You should see the version number printed. Then launch the browser:

astronomo

This opens Astronomo with the default home page. Press Ctrl+Q to quit.

Optional Features

Inline Image Display (Chafa)

Astronomo can display images (PNG, JPEG, GIF, WebP) as ANSI art directly in the terminal using Chafa. This feature is optional and requires the chafa.py package.

Install with pip:

pip install astronomo[chafa]

Install with uv tool:

uv tool install astronomo --with chafa.py

From source (development):

uv sync --group chafa

After installation, enable image display in Settings (Ctrl+,) → Appearance → Show Images.

Next Steps