Run events locally
Prove the whole arm → schedule → fire → deliver loop on your laptop in five minutes — no channels, no Activepieces, no cloud.
This is the smallest possible events run: two local processes, the native scheduler, and the
built-in web chat. You'll arm a standing flow by messaging CUGA /automate … and watch it fire.
No bot tokens, no public URL, no Activepieces.
What you need
Just your LLM credentials and one generated gateway token. That's it — 8 keys. Channels are
added later, one token at a time; without them, external channels simply show not_configured and
are skipped.
Write a minimal .env
Copy this into .env at the repo root and fill in your LLM values. (Not on watsonx? Swap the block
for settings.openai.toml + OPENAI_API_KEY, etc.)
# ── LLM (required) ──
AGENT_SETTING_CONFIG=settings.watsonx.toml
LLM_PROVIDER=watsonx
LLM_MODEL=<your model, e.g. openai/gpt-oss-120b>
WATSONX_APIKEY=<your key>
WATSONX_URL=https://us-south.ml.cloud.ibm.com
WATSONX_PROJECT_ID=<your project id>
WATSONX_SPACE_ID=<your space id>
# ── the /run + /invoke shared secret (required) ──
GATEWAY_TOKEN=<generate: python3 -c "import secrets; print(secrets.token_urlsafe(32))">
# ── turn events on + a durable local DB (recommended) ──
CUGA_EVENTS_ENABLED=true
EVENTS_DB=/absolute/path/to/your/clone/events.dbEVENTS_DB is a real SQLite file, so armed flows survive a restart. Omit it and the store is
in-memory (wiped on restart). See the Keys page for the two optional niceties
(EVENTS_WEBHOOK_KEY, CUGA_SECRET_KEY).
Boot both services
uv sync --python 3.12
make up-noapmake up-noap starts CUGA (:7860, agent + UI) and the events service (:8100, triggers +
concierge + native scheduler) with no Activepieces and no tunnel. Stop them anytime with
make stop.
Confirm events are on
curl -s localhost:7860/health && echo
curl -s localhost:8100/health && echo
curl -s localhost:8100/api/events/status | python3 -m json.tool | grep -E 'enabled|scheduler'
# → "enabled": true , "scheduler": "native"Open http://localhost:7860 — because events are on, a Studio tab appears in the top nav (channels + armed flows).
Arm a flow with /automate
In the main chat box, type:
/automate every minute send me the price of bitcoinCUGA proposes the standing flow — reply yes to arm it. Within a minute the native scheduler fires it and the agent's answer lands back in the web chat. Try a poll too:
/automate check the weather in Tokyo every minute and only tell me if it changedThat is the entire events loop — arm → schedule → fire → deliver — with no channels and no cloud.
Prove it from the command line (optional)
EVENTS_SERVER_URL=http://localhost:8100 EVENTS_SCHEDULER=native \
.venv/bin/python tests/events/live_fire.py --only cron poll # → 2 of 2 firedNext
- Add a channel so you can talk to CUGA from Slack / WhatsApp / Telegram / Discord → Channels
- Add a trigger so CUGA watches GitHub / Box / a webhook → Triggers
- See every variable, grouped by what you turn on → Keys
- Ship it to the cloud → Deploy to Code Engine
Events & Channels
Give CUGA a life outside the chat box — let it watch the world, react to events from your tools, and talk to you on Slack, WhatsApp, Telegram and Discord.
Keys & environment
Every environment variable the events layer reads, grouped so you only read the rows for the pieces you turn on.
