Open Source

The Sisy
Framework

A generic, open-source automation framework that packages repeatable patterns into a simple, reusable setup. The portable substrate you can create many instances from.

What is the Sisy Framework?

The Sisy framework (SisyCore / SisyCLI / SisyAPI) packages the repeatable patterns from the Freelance Automation Project and AgentCore ecosystem into a simple, reusable setup.

Sisy is not a full "64 crews out of the box" system. It is the portable substrate - a replicable automation base you can create many instances from (per client, per domain, per environment) from one codebase.

Framework Components

SisyCore

Shared runtime abstractions - the engine that everything else builds on.

SisyCLI

Local developer and operator tooling - your command-line interface.

SisyAPI

HTTP API and webhooks - enables external triggers and integrations.

SisyBench

Workbench for templates, examples, and reference implementations.

SisyBot

Orchestration bot - routes events, schedules workflows, runs playbooks.

Sisy (Umbrella)

The top-level project containing all packages in a unified monorepo.

Architecture

Entry Points

The Sisy framework can be triggered from multiple sources:

Cron / scheduled tasks HTTP triggers (API calls) Notion webhook events Chat interfaces (Discord-first)

Runtime Flow

Event SisyBot (Router) Crew Handler(s) Tool Calls / Plugins

Monorepo Layout

sisy/
  packages/
    sisy-core          # shared runtime abstractions
    sisy-cli           # developer/operator tooling
    sisy-api           # HTTP API + webhooks
    sisy-bench         # templates and reference implementations
    sisy-bot           # orchestration and event routing
  plugins/
    plugin-observability
    plugin-notion-sync
    plugin-video
  examples/
    freelance-automation-reference
  docs/

Key Concepts

Instances

Runnable units with their own configuration, plugins, secrets, and deployment target. Spin up one instance per client, project, or environment.

Plugins

Capability bundles that extend the framework. Initial families: Observability, Notion Sync, and Video Pipeline.

Crews & Dispatch

Optional but first-class architectural patterns. A Crew is a domain department, the Dispatcher routes work to the right crew.

Setup Profiles

Minimal

SisyCore + SisyCLI

Solo developer, local automation, getting started.

sisy init --profile minimal

API

Minimal + SisyAPI

Exposing automations via HTTP, webhook integrations.

sisy init --profile api

Workbench

API + SisyBench + Plugins

Full setup, reference implementations, experimenting.

sisy init --profile workbench

CLI Commands

sisy init --profile <name> Initialize a new Sisy instance with a setup profile
sisy run <workflow> Execute a workflow or playbook
sisy doctor Check environment, dependencies, and configuration health
sisy plugin add <name> Install and register a plugin
sisy plugin list List all installed plugins
sisy logs View runtime logs and event history
sisy deploy Deploy the current instance to a target environment

Tech Stack

Node.js monorepo TypeScript runtime commander.js CLI Express / Fastify Event-driven dispatcher Manifest-based plugins Notion MCP Discord MCP

Get Started

Explore the framework, contribute, or build your own automation instance.

Join the Community