```
░█▀▀░█▀█░█▀▀░▀█▀░█▀█░█▀▄░█░░█░█
░█▀▀░█▀█░█░░░░█░░█░█░█▀▄░█░░░█░
░▀░░░▀░▀░▀▀▀░░▀░░▀▀▀░▀░▀░▀▀▀░▀░
```

<center>

# Factorly

[![Release](https://img.shields.io/badge/Release-v0.19.3-blue?logo=github)](https://github.com/factorly-dev/factorly/releases)
[![Go](https://img.shields.io/badge/Go-1.26+-00ADD8?logo=go&logoColor=white)](https://go.dev)
[![License: GPL-3.0](https://img.shields.io/badge/License-GPL--3.0-green.svg)](LICENSE)
[![CI](https://img.shields.io/badge/CI-passing-brightgreen?logo=github)](https://github.com/factorly-dev/factorly/actions/workflows/ci.yml)
[![npm](https://img.shields.io/npm/v/factorly)](https://www.npmjs.com/package/factorly)
[![PyPI](https://img.shields.io/pypi/v/factorly)](https://pypi.org/project/factorly/)
[![MCP](https://img.shields.io/badge/MCP-compatible-8A2BE2)](https://modelcontextprotocol.io)
[![Docs](https://img.shields.io/badge/Docs-docs%2F-informational)](docs/)

**Build what your agent can do.**

Define tools, compose workflows, test and run them.
MCP servers, REST APIs, and CLI commands in one config, one UI, one audit log.

</center>

Factorly is a local runtime for agent tool chains. It manages tool calls, injects credentials from an encrypted vault, enforces governance rules, and logs everything. Your agent sees workflows, tools, and data. It never receives your credentials, only the tool's response. Secrets stay secret.

![Screenshot of Factorly UI](docs/images/screenshot-rm.png)

---


## Install

Install with your package manager of choice:

```bash
brew install factorly-dev/tap/factorly
  # or: npm install -g factorly
  # or: pip install factorly
  # or: go install github.com/factorly-dev/factorly@latest
```

## Quick Start

Zero config: wrap any existing MCP server and it's instantly callable through Factorly:

```bash
factorly wrap -- npx -y @modelcontextprotocol/server-everything
```

Then set up a project: install a blueprint, store credentials, and sync with your agent:

```bash
# 1. Create a project config + install a blueprint (41 services: GitHub, Slack, Stripe, Linear, Gmail, ...)
factorly init
factorly blueprint install github

# 2. Store credentials in the encrypted vault (or: factorly auth login github)
factorly vault set GITHUB_TOKEN ghp_xxxxxxxxxxxx

# 3. Confirm it's wired up
factorly tools status

# 4. Connect to your agent (auto-detects Claude Code, Cursor, Codex), then reload it
factorly sync

# 5. Optional — browse, edit, and try tools in the UI
factorly ui
```

Your agent connects to Factorly as a single MCP server or CLI and sees every tool you've configured. Your agent never possesses the credential — Factorly resolves `{{vault:KEY}}` references at call time and only the resolved request leaves the box. Full walkthrough: [Getting Started](docs/getting-started.md).

---

## What It Does

**Define** — one config, every protocol, [40+ blueprints](docs/blueprints.md) included

**Test** — Try tools in the [UI](docs/ui.md), see the response, iterate before giving your agent access

**Compose** — [workflows](docs/workflows.md) with per-step policies, deterministic sequences

**Govern** — [vault](docs/vault.md), [policies](docs/examples/10-deny-dangerous-operations.md), [audit log](docs/logging.md). Built in, not bolted on.

```
┌────────────┐       ┌────────────┐       ┌────────────┐
│            │       │            │       │            │
│ Your Agent │──────▶│  Factorly  │──────▶│ Your Tools │
│            │       │            │       │            │
└────────────┘       └────────────┘       └────────────┘
  Sees:                Vault               REST APIs
  - tool names         Governance          CLI commands
  - workflows          Audit log           MCP servers
  - data               Rate limits

  Never sees:
  - API keys
  - tokens
  - credentials
```

---

## Docs

- [Getting Started](docs/getting-started.md)
- [Configuration](docs/config-reference.md)
- [CLI Reference](docs/cli-reference.md)
- [Web UI](docs/ui.md)
- [Workflows](docs/workflows.md)
- [Expressions](docs/expressions.md)
- [Output Filters](docs/filters.md)
- [Blueprints](docs/blueprints.md)
- [Vault](docs/vault.md)
- [OAuth](docs/oauth.md)
- [Logging](docs/logging.md)
- [OpenAPI Import](docs/openapi-import.md)
- [Examples](docs/examples/)

## License

[GPL-3.0](LICENSE)