https://github.com/intelligencedev/manifold
Manifold is an experimental platform for enabling long horizon workflow automation using teams of AI assistants.
https://github.com/intelligencedev/manifold
agents artificial-intelligence automation go llm retrieval-augmented-generation visual-coding vuejs
Last synced: 3 days ago
JSON representation
Manifold is an experimental platform for enabling long horizon workflow automation using teams of AI assistants.
- Host: GitHub
- URL: https://github.com/intelligencedev/manifold
- Owner: intelligencedev
- License: mit
- Created: 2025-02-04T23:28:34.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2026-03-02T02:50:27.000Z (3 months ago)
- Last Synced: 2026-03-02T06:40:34.426Z (3 months ago)
- Topics: agents, artificial-intelligence, automation, go, llm, retrieval-augmented-generation, visual-coding, vuejs
- Language: Go
- Homepage: https://intelligence.dev
- Size: 101 MB
- Stars: 482
- Watchers: 11
- Forks: 29
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
- awesome-hacking-lists - intelligencedev/manifold - Manifold is a platform for enabling workflow automation using AI assistants. (Vue)
README
# Manifold
Manifold is an **experimental** platform for long-horizon workflow automation with teams of AI assistants.
It supports OpenAI, Google, and Anthropic models, along with OpenAI-compatible APIs for self-hosted open-weight models served through [llama.cpp](https://github.com/ggml-org/llama.cpp) or [vLLM](https://github.com/vllm-project/vllm).
> [!WARNING]
> Manifold is an experimental frontier AI platform. Do not deploy it in production environments that require strong stability guarantees unless this README explicitly states otherwise.
## What Manifold does
Manifold is built for workflows that go beyond one-shot prompts. It gives you a workspace where specialists, tools, projects, and workflows can work together on multi-step objectives over extended periods.
## Features
### Agent chat
Use a traditional chat interface to assign objectives to specialists. Agent specialists can be configured to render visualizations in addition to text responses.
_Specialists can collaborate across multiple turns. Manifold is designed to take advantage of the long-horizon capabilities of frontier models and can work on complex objectives for hours._
### Image generation
Manifold supports image generation with OpenAI and Google models, as well as local image generation through a custom ComfyUI MCP client.
_Example ComfyUI-generated image using a custom workflow._
### Observability (work in progress)
### Pulse - Scheduled Tasks
Schedule tasks for agent specialists to execute in time intervals, daily, or only once at a defined date and time. Send results to various external services. Matrix is natively supported, but Skills or MCP's can extend the channels Manifold has access to.
### Workflow editor
Design agent workflows with a visual flow editor. __MCP tools are exposed as nodes automagically. Saved workflows become tools that can be invoked by specialists or inserted as nodes into other workflows.__ It's workflows all the way down.
### Specialist registry
Define and configure AI agents, then build your own team of experts.
### Projects
Configure projects as agent workspaces.
Each project is isolated to its own root path. Agents only load skills from that project's `.skills/` folder, so every project that needs reusable skills must define its own `.skills` directory inside the project root.
### Integrated tools and MCP support
Manifold includes built-in tools for agent workflows and supports MCP to extend agent capabilities. You can configure multiple MCP servers and enable tools individually to manage context size more precisely.
### Prompts, datasets, and experiments playground
Create, iterate on, and version prompts that can be assigned to agents. Configure datasets and run experiments to understand how prompt changes affect agent behavior.
## Deploy a fresh clone
The recommended first-run path is Docker-based and does **not** require a local Go, Node, or `pnpm` toolchain.
### Prerequisites
For a basic local deployment, you need:
- Docker with Docker Compose support
- An LLM API key or a reachable OpenAI-compatible endpoint
- A writable host directory to use as `WORKDIR`
Optional local tooling is only needed if you are developing Manifold itself:
- Node 22 and `pnpm` for running the frontend outside Docker
- Go 1.25 for local binary builds
- Chrome or another Chromium-compatible browser if you plan to use browser-driven tools from a host build
### Fast path
```bash
cp example.env .env
cp config.yaml.example config.yaml
# Edit .env and set at minimum:
# OPENAI_API_KEY=...
# WORKDIR=/absolute/path/to/your/manifold-workdir
docker compose up -d pg-manifold manifold
```
Then open .
### Self-contained host run
Manifold can also run without external database or telemetry services when you build `agentd` locally. Enable the embedded Postgres runtime and keep ClickHouse/OTLP unset:
```yaml
databases:
embedded: true
defaultDSN: ""
obs:
otlp: ""
local:
enabled: true
clickhouse:
dsn: ""
```
With that configuration, `agentd` starts a bundled PostgreSQL process for durable state and serves metrics, logs, and traces from bounded process-local telemetry. You still need an LLM provider, which can be a remote API key or a local OpenAI-compatible endpoint.
For the full deployment walkthrough, see:
- [QUICKSTART.md](./QUICKSTART.md)
- [docs/deployment.md](./docs/deployment.md)
- [docs/matrix-gateway.md](./docs/matrix-gateway.md)
## Developers
### Frontend feature gates
`make build-manifold` builds `agentd` with the embedded frontend using the stable UI feature gate. Stable builds do render frontend undocumented features still in active development.
To build the same backend and embedded frontend with beta UI links enabled, use either command:
```bash
make build-manifold-beta
make build-manifold FEATURE_GATE=beta
```
The build passes `FEATURE_GATE` through to Vite as `VITE_MANIFOLD_FEATURE_GATE`.