explaingit

sandydasari/openacme

14TypeScriptAudience · developerComplexity · 3/5Setup · moderate

TLDR

A self-hosted multi-agent AI platform that runs on your own laptop as a background service, letting you set up a named team of AI assistants each with its own role, memory, and model choice.

Mindmap

mindmap
  root((openacme))
    Architecture
      Agent folders on disk
      SQLite task history
      Shared task board
    AI providers
      Anthropic
      OpenAI
      Google
    Use cases
      Multi-agent workflows
      Local AI team
      Background service
    Interface
      Web dashboard
      Terminal UI
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Build a local team of AI agents with different roles (manager, coder, writer) to tackle complex multi-step projects

USE CASE 2

Set up a background AI service that starts at login and surfaces tasks needing your input while running autonomously otherwise

USE CASE 3

Run a manager-worker hierarchy where one agent breaks down a goal and assigns subtasks to specialists in parallel

USE CASE 4

Query the full SQLite history of agent tasks, comments, and decisions for auditing or replay

Tech stack

TypeScriptNode.jsSQLitenpm

Getting it running

Difficulty · moderate Time to first run · 30min

Requires npm and at least one AI provider account (Anthropic, OpenAI, or Google) to supply API keys.

In plain English

OpenAcme is a platform for running a group of AI agents on your own laptop, organized like a small company. Instead of chatting with a single AI assistant, you set up multiple named agents, each with its own role, persona, memory, and choice of AI model. You decide how they relate to each other: a flat group of specialists you talk to directly, a manager agent that breaks down your requests and assigns pieces to others, or a layered structure with team leads and individual contributors. The core idea is that you hand the group a goal, and agents divide the work, track dependencies, and run in parallel where they can. Decisions they cannot make on their own surface as tasks waiting for your input. You answer those and the rest continues without you. For simpler tasks you can skip the hierarchy entirely and send a request straight to one specific agent. Each agent is stored as a folder on disk with a plain text file describing its role and persona, a workspace, and its own memory that persists across sessions. You can add or remove agents at any time, switch which AI provider or model one uses, or reshape its persona. A shared task board keeps every agent coordinated, and a SQLite database stores the full history of tasks, comments, and events so you can query or back it up directly. The tool runs as a background service on macOS and Linux. It registers with the system so it starts automatically at login. A web interface shows which agents are active, who is waiting for you, what tasks are on the board, and chat histories with each agent. You can also use a terminal interface if you prefer. You connect it to AI providers you already have accounts with, including Anthropic, OpenAI, Google, and others. Nothing leaves your machine except the prompts you send to whichever model provider you chose. The project is written in TypeScript and distributed as an npm package.

Copy-paste prompts

Prompt 1
I want to set up openacme with a manager agent and three specialists (coder, designer, writer). Show me the folder structure and persona files I need to create.
Prompt 2
Using openacme, how do I configure a hierarchy where the manager assigns subtasks to workers and pauses for my input when blocked?
Prompt 3
Walk me through connecting openacme to both Anthropic Claude and OpenAI GPT-4 so different agents use different models.
Prompt 4
How do I query openacme's SQLite database to review all tasks and agent decisions from the past week?
Open on GitHub → Explain another repo

← sandydasari on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.