Skip to content

INSTALLATION.md

Latest commit

 

History

History
105 lines (70 loc) · 2.53 KB

INSTALLATION.md

File metadata and controls

105 lines (70 loc) · 2.53 KB

Astromesh Installation Guide

Debian Package (Recommended)

1. Download from GitHub Releases

curl -LO https://github.com/monaccode/astromesh/releases/latest/download/astromesh_<VERSION>_amd64.deb
sudo apt install ./astromesh_<VERSION>_amd64.deb

2. Configure

Edit the provider configuration with your API keys:

sudo nano /etc/astromesh/providers.yaml

Review and adjust the runtime configuration:

sudo nano /etc/astromesh/runtime.yaml

3. Start the service

sudo systemctl start astromeshd
sudo systemctl status astromeshd

4. Verify

astromeshctl status

Post-Install

File locations

Path Description
/etc/astromesh/ Configuration files (preserved on upgrade)
/opt/astromesh/venv/ Python virtual environment
/var/lib/astromesh/ Runtime data (models, memory, data)
/var/log/astromesh/ Logs and audit trail
/usr/bin/astromeshd Daemon binary (symlink)
/usr/bin/astromeshctl CLI tool (symlink)

Agent configuration

Agent definitions are in /etc/astromesh/agents/. Each .agent.yaml file defines an agent with its model, tools, prompts, and orchestration settings.

Installing additional dependencies

The base package includes minimal dependencies. To add ML or vector store backends, install them into the Astromesh venv:

sudo /opt/astromesh/venv/bin/pip install torch faiss-cpu sentence-transformers

Upgrading

curl -LO https://github.com/monaccode/astromesh/releases/latest/download/astromesh_<VERSION>_amd64.deb
sudo apt install ./astromesh_<VERSION>_amd64.deb

Your configuration files in /etc/astromesh/ are preserved during upgrades. If a new version ships updated defaults, apt will ask how to handle the difference.

Uninstalling

Keep data and configuration

sudo apt remove astromesh

This removes the package but preserves /var/lib/astromesh, /var/log/astromesh, /etc/astromesh, and the astromesh user.

Remove everything

sudo apt purge astromesh

This removes all files, data, logs, and the astromesh system user.

Manual Installation

Download the .deb directly from GitHub Releases:

curl -LO https://github.com/monaccode/astromesh/releases/latest/download/astromesh_<VERSION>_amd64.deb
sudo dpkg -i astromesh_*_amd64.deb
sudo apt-get -f install  # resolve dependencies if needed

Requirements

  • Ubuntu 22.04+ / Debian 12+
  • Python 3.12+
  • systemd