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”
Terminal window
# Download the latest release
curl -LO https://github.com/monaccode/astromesh/releases/latest/download/astromesh_latest_amd64.deb


# Install
sudo apt install ./astromesh_latest_amd64.deb

Verify the installation:

Terminal window
astromeshctl version

Expected output:

Astromesh Node v0.18.0
Daemon:  /opt/astromesh/bin/astromeshd
CLI:     /opt/astromesh/bin/astromeshctl
Python:  3.12.x
Platform: linux/amd64

Step 2: Initialize

Section titled “Step 2: Initialize”

Run the interactive configuration wizard. This generates your runtime.yaml, providers.yaml, and a default agent:

Terminal window
sudo astromeshctl init --profile full

The wizard prompts for your LLM provider (Ollama, OpenAI, Anthropic, etc.) and memory backend. For a quick start with a local model:

? Select deployment profile: full
? Select provider: Ollama (local)
? Ollama endpoint: http://localhost:11434
? Select model: llama3.1:8b
? Enable memory? Yes
? Memory backend: SQLite (local)
? Enable observability? No


Configuration written to /etc/astromesh/

To use a specific profile without the interactive wizard, pass --profile and provider flags:

Terminal window
sudo astromeshctl init --profile full --provider ollama --model llama3.1:8b --non-interactive

Step 3: Start the Service

Section titled “Step 3: Start the Service”
Terminal window
sudo systemctl enable astromeshd
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:

┌──────────────────────────────────────┐
│         Astromesh Status             │
├──────────────┬───────────────────────┤
│ Status       │ ● Running             │
│ Version      │ 0.18.0                │
│ Uptime       │ 0h 0m 12s             │
│ Profile      │ full                  │
│ PID          │ 4521                  │
│ Agents       │ 1 loaded              │
│ Providers    │ 1 healthy, 0 degraded │
│ Memory       │ 128.0 MB              │
└──────────────┴───────────────────────┘

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, call the API:

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

Expected response:

{
  "agent": "default",
  "response": "Hello! I'm your Astromesh assistant. I can answer questions, help with research...",
  "session_id": "sess_abc123",
  "tokens_used": 42
}

Next Steps

Section titled “Next Steps”