kosmorro
Execute actions automatically based on scheduled times
TLDR
Get ephemerides for Paris, France
Get ephemerides for Paris, France, in the UTC+2 timezone
Get ephemerides for Paris, France, on June 9th, 2020
Generate a PDF (Note: TeXLive must be installed)
SYNOPSIS
kosmorro {
kosmorro cli
kosmorro gui
kosmorro api [--host ] [--port
kosmorro console
PARAMETERS
cli
Launches the interactive command-line interface for Kosmorro, providing a dedicated shell environment for planning and simulation.
gui
Starts the graphical user interface of Kosmorro, offering a visual way to interact with the software's features.
api
Launches the RESTful API server for programmatic access to Kosmorro's features, allowing integration with other applications.
console
Opens an interactive Python console with the Kosmorro library pre-loaded, useful for direct scripting and development.
--host
For the api subcommand, specifies the host address on which the API server will listen (default: 0.0.0.0, meaning all available interfaces).
--port
For the api subcommand, specifies the port number on which the API server will listen (default: 8000).
--debug
For the api subcommand, enables debug mode for the API server, providing more verbose output and potentially developer tools.
DESCRIPTION
Kosmorro is an open-source, Python-based application designed for personal space travel planning. It offers robust tools for orbital mechanics simulation, enabling users to determine celestial body positions, calculate orbits, and find optimal trajectories. The software also incorporates a spacecraft builder to define vehicle characteristics like mass and delta-v, and includes a comprehensive database of celestial bodies, spacecraft, and spaceports. Kosmorro supports multiple modes of interaction: as a Python library, through its graphical user interface (GUI), or via its command-line interface (CLI). The CLI primarily consists of interactive subcommands, allowing users to explore and plan within a dedicated shell environment or launch its various services.
CAVEATS
Kosmorro is not a standard Linux system utility; it must be installed as a Python package, typically via pip. Its command-line interface is primarily designed for interactive subcommands rather than single-shot scriptable operations (with the exception of launching services like the API). Data for celestial bodies and spacecraft may require initial download or updates.
INSTALLATION
Kosmorro is typically installed using Python's package manager. You can install it with: pip install kosmorro. Ensure you have a compatible Python environment (e.g., Python 3.8+).
INTERACTIVE CLI
When you run kosmorro cli, you enter an interactive shell where you can type commands like 'plan_trip', 'show_body', etc., rather than passing all arguments directly on the initial command line. Type 'help' within the shell for a list of available commands.
HISTORY
Kosmorro is an actively developed, open-source project hosted on GitHub, created to provide a comprehensive personal space travel planning tool. Its development leverages modern Python libraries for its various components, including argparse for CLI parsing, cmd2 for interactive shell features, FastAPI for the API, and PyQt for the GUI. This contemporary stack suggests a focus on maintainability and user experience from its inception.