Getting Started

Welcome to the OpenStrate Constellation. This guide will help you set up your first satellite and ignite your first mission.

Prerequisites

• Linux (Ubuntu/Debian recommended for Bubblewrap support)
• Python 3.10+
• Docker (optional, but recommended for some components)
• bubblewrap installed (sudo apt install bubblewrap)

1. Install the CLI

The ostr command is your primary interface. Install it using pip (or uv):

pip install openstrate-cli

2. Boot a Satellite

To join the constellation, you need to run a local satellite node.

ostr sat start

This will register your machine with the default public constellation and start listening for missions.

3. Ignite your first Nova

Use the ignite command to describe what you want to run.

ostr ignite "Calculate pi to 1000 places and show me the output"

Nova will process your request, find your local satellite, and execute the task. You can watch the progress in your terminal or open Aperture.

4. Open Aperture

Visualize your missions in real-time:

ostr view