Skip to main content

Quickstart — 5 Minutes to a Running Agent

Prerequisites​

  • Python 3.11+
  • pip

Boot It​

git clone https://github.com/Manifesto-Engine/SovCore.git
cd SovCore
pip install -r requirements.txt
uvicorn main:app --port 8000

You'll see the scheduler ticking in your terminal every 10 seconds.

Verify It's Running​

Open a second terminal:

# Health check
curl http://localhost:8000/

# Engine status + capabilities
curl http://localhost:8000/engine/status

# Runtime metrics (tick count, uptime, pipeline stats)
curl http://localhost:8000/engine/pulse

Store and Retrieve Data​

# Store a memory
curl -X POST http://localhost:8000/cortex/remember \
  -H "Content-Type: application/json" \
  -d '{"content":"My first stored entry","tags":["test"],"importance":0.8}'

# Search memories
curl "http://localhost:8000/cortex/recall?query=first"

# Recent entries
curl http://localhost:8000/cortex/recent

Run a Pipeline​

The starter comes with a hello_world pipeline:

curl -X POST http://localhost:8000/engine/run \
  -H "Content-Type: application/json" \
  -d '{"name":"hello_world"}'

Interactive API Docs​

FastAPI auto-generates interactive documentation:

http://localhost:8000/docs

Every endpoint is testable directly from the browser.

What Just Happened​

When you ran uvicorn main:app, the runtime:

  1. Booted — runtime.init() initialized all four modules
  2. Started ticking — the scheduler fires every 10 seconds
  3. Began recording — every tick writes runtime metrics to the memory store
  4. Armed the health monitor — pipeline health tracking is active

It will continue running until you kill the server. On restart, it recovers its data from the memory store.

Next: Modules →