+1
日增长
1,845
stars
233
forks
7
watchers
1,066
prs
110
issues
107
releases
README
The Open-Source AI CRM for Selling Without a Sales Team
Website ·
Documentation ·
MCP Server ·
Roadmap ·
Discord
One request to Rela, the built-in AI assistant: three changes, applied after you approve them.
---
About Relaticle
Relaticle is a self-hosted CRM your AI agents can work in. Connect Claude, ChatGPT, or an open-source model over MCP to read, write, and analyze your CRM data. Custom fields, REST API, and multi-workspace isolation.
Built for: people who sell to a named list of companies without a sales team. Connect Claude, ChatGPT, or your own agent to work in the CRM.
Core Strengths:
- Agent-Native Infrastructure - MCP server and REST API with full CRUD, schema access, activity history, and pipeline analysis
- Customizable Data Model - Custom fields for text, dates, currency, selects, and links between records, with per-field encryption. No migrations needed.
- Multi-Workspace Isolation - Workspace-scoped data with role-based permissions
- Modern Tech Stack - Laravel 13, Filament 5, PHP 8.5, with an automated test suite on every change
- Privacy-First - Self-hosted, AGPL-3.0, your data stays on your server
Connect an agent
Relaticle ships an MCP server, so the agents you already use can work in your CRM.
- Claude: add a connector with the URL https://mcp.relaticle.com (hosted) or https://your-host/mcp (self-hosted).
- ChatGPT: install Relaticle from the plugin directory.
- Claude Code, Cursor, Gemini CLI: plugins and the extension live in relaticle/agent-plugins.
- Anything else that speaks MCP: Streamable HTTP, OAuth 2.1 or a personal access token, one workspace per connection. Setup in the MCP guide.
Run with Docker
The fastest way to self-host. Six containers: the app, a queue worker, a scheduler, a websocket server, PostgreSQL, and Redis.
1. Download the compose file:
bash
curl -o compose.yml https://raw.githubusercontent.com/Relaticle/relaticle/main/compose.yml
2. Generate an application key:
bash
echo "APP_KEY=base64:$(openssl rand -base64 32)"
3. Create a .env file with your settings:
bash
APP_KEY=base64:your-generated-key-here
DB_PASSWORD=your-secure-database-password
APP_URL=https://crm.example.com
4. Start the containers:
bash
docker compose up -d
5. Create your admin account:
bash
docker compose exec app php artisan make:filament-user
Your CRM is now available at {APP_URL}/app. The Self-Hosting Guide covers configuration, updates, backups, and a manual deployment. The sections below are for running from source.
Requirements
- PHP 8.5+
- PostgreSQL 17+
- Composer 2 and Node.js 22+
- Redis for queues (optional for development)
Installation
bash
git clone https://github.com/Relaticle/relaticle.git
cd relaticle && composer app-install
Development
bash
Start everything (server, queue, vite)
composer dev
Run tests
composer test
Format code
composer lint
Self-Hosting
See the Self-Hosting Guide for Docker and manual deployment instTop issues
#881Assistant gaps from a week of production conversations: 25 items, 3 PRs5 comments · 2026-10-02#885Merge duplicate companies and people1 comments · 2026-10-02#495AI assistant: semantic retrieval over notes and emails (pgvector RAG)1 comments · 2026-08-18#1194Favorites: pin companies, people and opportunities to the sidebar, with folders0 comments · 2026-11-14#1160Signup burst on Nov 9: 26 accounts in 75 minutes, 23 never verified0 comments · 2026-11-11#1155Web push for due tasks on home-screen installs0 comments · 2026-11-10#1126Remove the rich editor dropdown guard once Filament fixes getTrigger0 comments · 2026-11-07#1070Research: sequences of manual follow-up tasks that stop when the person responds0 comments · 2026-11-01
Latest release
v3.9.2 v3.9.2 2026-11-13What's Changed fix(workspaces): require a verified email to join, decline or connect by @ManukMinasyan in https://github.com/relaticle/relaticle/pull/1168 fix(records): check permission before linking tasks and notes from a record by @ManukMinasyan in https://github.com/relaticle/relaticle/pull/1169 fix(sysadmin): keep plan changes on reset period to super administrators by @ManukMinasyan in https://github.com/relaticle/relaticle/pull/1170 fix(custom-fields): refuse field changes after a member's role is lowered by @ManukMinasyan in https://github.com/relaticle/relaticle/pull/1171