jicaiinc/golemancy

Golemancy is a free, open-source desktop app that gives one person the power of a full AI team. Create AI agents for research, writing, translation, data analysis, marketing, and reporting — equip them with tools and skills, and let them work in parallel. All running locally on your machine.

Features

Multi-Agent Orchestration — Summon multiple AI agents in isolated projects. Each agent runs independently with its own context, tools, and mission.

Recursive Sub-Agents — Agents spawn sub-agents with unlimited nesting. One command triggers an entire autonomous workforce, streaming results in real-time.

Teams — Organize agents into structured teams with a visual topology editor. Define leader/member hierarchies, assign roles, and run entire teams in a single conversation.

9+ LLM Providers — Claude, GPT, Gemini, DeepSeek, Groq, Mistral, and more. Switch models per agent. Use the right brain for every task.

MCP Protocol — Native Model Context Protocol support with connection pooling. Plug into the expanding MCP ecosystem out of the box.

Browser Automation — 16 built-in tools and 80+ operations powered by Playwright. Your agents don't just think — they browse, click, and extract.

Skill System — Equip agents with reusable prompt templates. Create, share, and import skill packs like equipping items in an RPG.

Agent Memory — Agents remember what matters. Persistent, agent-scoped memory stored in SQLite — pinned facts always load, others ranked by priority and recency. Full CRUD via built-in memory tools.

Workspace — Built-in file browser and previewer for your project workspace. Navigate, inspect, and reference files without leaving the app.

Voice Input — Speak your prompts. Built-in speech-to-text powered by your preferred provider, with full transcription history.

Cron Scheduling — Set it and forget it. Schedule agents to run on autopilot — daily reports, periodic scraping, recurring workflows.

Local-First Security — Your data never leaves your machine. Loopback-only server, per-session auth tokens, three-tier sandboxed permissions.

Quick Start

Download

Grab the latest release for your platform:

Download Golemancy — available for macOS, Windows, and Linux.

Build from Source

Prerequisites: Node.js (v22+) and pnpm (v10+).

# Clone the repository
git clone https://github.com/jicaiinc/golemancy.git
cd golemancy

# Install dependencies
pnpm install

# Start development
pnpm dev

# Or build for distribution
pnpm dist

Architecture

Golemancy is a monorepo with a clear one-way dependency chain:

apps/desktop/      Electron shell — forks server as child process
packages/ui/       React UI, business logic, Zustand store
packages/server/   Hono HTTP server, SQLite, AI agent runtime
packages/shared/   Pure TypeScript types (zero runtime)
packages/tools/    Browser automation (Playwright-based)

desktop → ui → shared ← server ← tools

The Electron main process forks the server as a child process on a random port. All communication flows over HTTP to localhost with per-session Bearer token auth. Each project gets its own SQLite database.

Tech Stack

Contributing

We welcome contributions! Here's how to get started:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Make your changes
4. Run tests (pnpm test) and type-check (pnpm lint)
5. Submit a pull request

For bugs and feature requests, open an issue.

Community

• Discord — Chat, get help, share what you build
• Twitter — Updates and announcements
• Email — hi@golemancy.ai

Star History

License

Apache License 2.0