Skip to content

Soulacy

One binary. YAML agents. Runs anywhere — no cloud required.

Soulacy is a self-hosted AI agent runtime. Write an agent in a single YAML file, point it at any LLM (Ollama, OpenAI, Anthropic, Gemini, or anything OpenAI-compatible), and run it from a laptop, a $5 VPS, or a Raspberry Pi — with a full web GUI, chat, voice, scheduling, memory, skills, and plugins built into the one binary.

Think of it as Ollama — but for agents.

Build it. Run it. Fix and learn.

  • Build it — describe what you want in plain English in Studio, or start from a template. Soulacy drafts the plan, generates the workflow, and checks it end-to-end before you save.
  • Run it — deploy to Telegram, Slack, Discord, WhatsApp, HTTP, or a schedule. One binary, no cloud required.
  • Fix and learn — when a run fails, Debug in Studio explains it plainly and proposes a fix you can preview; successful repairs become regression tests, and the learning loop shows what Soulacy has learned.
# install, set up, talk to your first agent — under five minutes
curl -fsSL https://vmodekurti.github.io/soulacy/install.sh | bash
sy setup
sy chat --agent assistant "What can you do?"

Get started Tour the GUI

What you can build

  • Agents from one YAML file

    Identity, LLM, tools, memory, schedule — one SOUL.yaml per agent. Edit in the GUI or your editor; changes hot-reload.

    SOUL.yaml reference

  • Chat with branching & voice

    Fork a conversation from any message, watch reasoning steps live, see per-reply token costs, or hold a realtime voice conversation.

    Chat · Voice

  • Every channel

    Telegram, Slack, Discord, WhatsApp, HTTP out of the box — or any platform via a sidecar process in the language of your choice.

    Channels

  • Skills & plugins, safely

    Install skills from skills.sh, GitHub, or your own registry. Every install runs a security pipeline; plugins are sandboxed, default-deny principals.

    Installing skills · Skill sources

  • Memory that learns

    Session/agent/global memory scopes, semantic vector search, and versioned procedural rulebooks the agent can update — with locks, diffs, and rollback.

    Memory & rulebooks

  • Workflows & flow graphs

    Linear steps or cyclic graphs with conditional edges and bounded loops — checkpointed, crash-resumable, rendered live on the Flow page.

    Flow graphs

  • Scheduling that catches up

    Cron agents with missed-run catch-up after downtime, a workboard with tasks, comments, and downloadable run artifacts.

    Schedules · Workboard

  • Observable & governable

    Every run emits schema-versioned events: live activity feed, signed webhooks, costs per agent, rate limits, RBAC, audit logs.

    Events & webhooks

Five-minute tour

  1. Install — one line on macOS, Linux, or Docker, then sy setup walks you through providers and channels. → Installation
  2. Meet the GUI — everything lives at http://localhost:18789: Dashboard, Agents, Chat, Workboard, Knowledge, Memory, Skills, Flow, Plugins. → GUI tour
  3. Write an agent — a complete SOUL.yaml walkthrough: prompt, tools, memory, schedule. → Your first agent
  4. Give it skills — sy registry add https://www.skills.sh/ then sy skill install anthropics/skills/skill-creator. → Skill sources
  5. Put it to work — bind a Telegram bot, schedule a daily run, or start from a shipped workflow template.

Why Soulacy

Soulacy n8n / Flowise / Dify LangGraph / AutoGen
Deploy Single binary, zero deps Docker + Postgres + Redis Python package
Config One YAML file per agent Visual editor (brittle exports) Code
Runs on Laptop, VPS, Raspberry Pi Needs a server stack Dev machine
LLM Any — local or cloud Mostly cloud Any
No-code GUI included in binary Yes No
Extensible Skills, plugins, sidecars in any language JS nodes Python
Security stack Untrusted-content envelope, injection scanner, intent gate, Security Doctor — shipped Third-party plugin Operator's problem

What Soulacy is NOT

Positioning honesty — say what we are, and what we aren't, so you can self-disqualify quickly if the fit's wrong.

  • Not a hosted SaaS. No soulacy.cloud. Ever. Self-hosted-first is the point of the product.
  • Not a LangGraph replacement. If you need explicit state-machine graphs with checkpoints and resumable execution, use LangGraph.
  • Not a personal assistant. Soulacy runs headless and delivers to channels; it doesn't ship a wake-word, a Canvas, or a native mobile app. If you want an iMessage / WeChat / Signal / Matrix personal assistant, use OpenClaw.
  • Not vendor-locked. Not tied to Anthropic, OpenAI, Google, or any provider. Provider-agnostic via config.
  • Not a low-code node editor for non-developers. Studio helps, but the audience is developers/ops who prefer YAML + Python tools.

Where to next