Skip to content
Astromesh Astromesh

Quick Start

This guide gets Astromesh Node installed and running on your system. Pick your platform and follow the steps.

Step 1: Install

Section titled “Step 1: Install”

Node releases are published on GitHub under node-v* tags (the repository’s “latest” release is the core, so releases/latest/download/... URLs do not find the Node packages). Set VERSION to the Node release you want:

Terminal window
VERSION=0.1.10
curl -LO https://github.com/monaccode/astromesh/releases/download/node-v${VERSION}/astromesh-node_${VERSION}_amd64.deb
sudo apt install ./astromesh-node_${VERSION}_amd64.deb

Verify the installation:

Terminal window
astromeshctl version

Expected output:

astromesh-cli 0.3.1
astromesh core 0.61.0

Step 2: Initialize

Section titled “Step 2: Initialize”

Run the interactive configuration wizard. Run as root, it writes /etc/astromesh/runtime.yaml and providers.yaml (on macOS and Windows the daemon reads a different directory — follow the macOS or Windows guide for this step):

Terminal window
sudo astromeshctl init

The wizard asks for a node role (full, gateway, worker, inference) and a provider (ollama, openai, anthropic, or skip). With Ollama it checks http://localhost:11434 and writes the config even if Ollama is not running yet; with OpenAI or Anthropic it asks for the API key and stores it in /etc/astromesh/.env, which the systemd unit loads.

To accept all defaults (role full, provider ollama) without prompts:

Terminal window
sudo astromeshctl init --non-interactive

Step 3: Start the Service

Section titled “Step 3: Start the Service”

The package already enables the unit; it does not start it.

Terminal window
sudo systemctl start astromeshd

Step 4: Verify

Section titled “Step 4: Verify”

Check that the daemon is running and agents are loaded:

Terminal window
astromeshctl status

Expected output (values vary):

   Astromesh Daemon Status
┏━━━━━━━━━━━━━━━┳━━━━━━━━━┓
┃ Property      ┃ Value   ┃
┡━━━━━━━━━━━━━━━╇━━━━━━━━━┩
│ Version       │ 0.59.0  │
│ PID           │ 4521    │
│ Mode          │ system  │
│ Uptime        │ 12.4s   │
│ Agents Loaded │ 10      │
└───────────────┴─────────┘

Run a full diagnostics check:

Terminal window
astromeshctl doctor

Step 5: Run Your First Agent

Section titled “Step 5: Run Your First Agent”

With the service running, pick an agent from astromeshctl agents list and call the API:

Terminal window
curl -s http://localhost:8000/v1/agents/support-agent/run \
  -H "Content-Type: application/json" \
  -d '{"query": "Hello! What can you do?"}' | jq .answer

The response carries answer, steps and usage; see POST /v1/agents/{name}/run.

Next Steps

Section titled “Next Steps”