Skip to content

RootCX/RootCX

Repository files navigation

The secure open-source* foundation for internal software and AI agents

Build a fleet of interconnected apps and AI agents with managed database, Auth, RBAC, and an AI desktop studio out of the box.
Fully managed, or self-hosted for absolute data sovereignty.

Documentation Discord License Stars

Website · Docs · Community · Get Started


RootCX Studio


Table of Contents

What is RootCX?

RootCX is an open-source* infrastructure for building custom internal software and AI agents. Build a unified fleet of interconnected apps that combines the experience of a modern SaaS with the robustness of an ERP. Full ownership of your code, absolute control over your data.

Develop locally. Deploy anywhere. Self-host or use our cloud.

Quickstart

1. Download Studio

RootCX Studio is the native desktop app where you build, deploy, and manage everything.

Platform Download
macOS (Apple Silicon) RootCX Studio (.dmg)
macOS (Intel) RootCX Studio (.dmg)
Windows RootCX Studio (.exe)
Linux (.deb) RootCX Studio (.deb)
Linux (.AppImage) RootCX Studio (.AppImage)

2. Connect to a Core

On first launch, Studio asks how you want to connect to a RootCX Core instance. You have two options:

Option A: RootCX Cloud (fastest)

No installation, no Docker, no infrastructure. A managed Core is provisioned for you in minutes.

  1. Sign up at rootcx.com/app/register.
  2. Create a project and hit Launch Project.
  3. Once active, copy the API URL from the project overview.
  4. In Studio, select Connect to a server and paste the URL.

You're ready to build. Your project gets its own dedicated Core with a managed database, API, authentication, and AI runtime.

Option B: Run locally with Docker

Run a Core instance on your own machine. Ideal for offline development or full control.

Prerequisite: Docker Desktop must be installed and running.

Via Studio: select Run locally on the welcome screen. Studio handles everything automatically.

Via command line:

git clone https://github.com/rootcx/rootcx.git && cd rootcx
docker compose up -d

Core will be available at http://localhost:9100 once both services are healthy.

For production self-hosting, see the Self-Hosting guide.

Architecture

RootCX Architecture

Core is a Rust daemon that powers your entire fleet. Every app and agent you deploy inherits the same enterprise primitives:

  • Managed PostgreSQL with automatic schema sync
  • Automatic CRUD APIs generated from your data model
  • JWT authentication and session management
  • Granular role-based access control (RBAC)
  • Immutable audit logs at the database trigger level
  • AES-256 encrypted secret vault
  • Isolated process supervisor with crash recovery
  • Background job queue
  • Real-time log streaming via SSE

Studio is a native desktop IDE built with Tauri. You use it to build apps, AI agents, integrations, and MCP servers. Each one is a standalone project with its own code, its own frontend, and its own backend logic. When deployed, they all connect to the same Core and share its database, auth, RBAC, and governance layer.

  • AI Forge: describe intent in plain language, get production-ready code
  • Visual database browser and schema manager
  • Governance UI for RBAC, audit logs, secrets, and auth
  • Integrated terminal and live log streaming
  • One-click deploy to any connected Core

Development

# Clone the repo
git clone https://github.com/rootcx/rootcx.git && cd rootcx

# Download bundled PostgreSQL + Bun
make deps

# Start Studio in dev mode (hot reload)
make dev

Prerequisites: Rust (latest stable), Node.js 18+, pnpm

Community

License

RootCX is licensed under the FSL-1.1-ALv2 (Functional Source License). You can use, modify, and redistribute the software for any purpose other than offering a competing product. The license automatically converts to Apache 2.0 after two years.

We chose FSL because it lets us build in the open. You get the full source, you can self-host, you can extend it, while protecting the project's ability to sustain itself. After two years, every release becomes fully permissive under Apache 2.0, no strings attached.


* RootCX is source-available under the FSL-1.1-ALv2, which converts to Apache 2.0 after two years.