Soliplex

An AI-powered Retrieval-Augmented Generation (RAG) system with a modern web interface.

Overview

Soliplex is a self-hosted, full-stack RAG/AI system: a FastAPI backend (a thin configuration and authentication layer around pydantic-ai), a hardened Flutter client, and a terminal UI.

See the Overview for what Soliplex is, when (and when not) to use it, how it compares to alternatives, and the full feature and architecture breakdown.

Quickstart

The fastest way to stand up and run your own Soliplex is to let a skills-compatible AI agent (e.g. Claude Code, Codex, Copilot) do it for you. Soliplex publishes two Agent Skills that teach your agent how to deploy and operate it – no need to clone or hack on this repository:

• soliplex-template scaffolds a complete, runnable Docker Compose stack (nginx, the Soliplex backend, the Flutter frontend, an ingester, Postgres, and a TUI). It prompts for the parameters you care about – project name, host ports, your Ollama URL, models, version pins, auth mode – and writes out the full project. Published from soliplex/soliplex-template.

• soliplex-docs is the full Soliplex documentation, so your agent can answer questions about installing, configuring, and operating your deployment straight from the official docs. Published from this repository.

Install the skills

Each skill is a tarball that unpacks into a soliplex-template/ or soliplex-docs/ directory. Install them by unpacking both into whichever directory your agent scans for skills. The directory differs per agent:

Point SKILLS_DIR at the row that matches your agent (the examples below use the Claude Code per-user location) and unpack both skills into it:

SKILLS_DIR=~/.claude/skills
mkdir -p "$SKILLS_DIR"

# Deployment scaffolder
curl -fsSL \
  https://github.com/soliplex/soliplex-template/releases/download/template-skill-latest/soliplex-template-skill.tar.gz \
  | tar xz -C "$SKILLS_DIR"

# Documentation
curl -fsSL \
  https://github.com/soliplex/soliplex/releases/download/docs-latest/soliplex-docs-skill.tar.gz \
  | tar xz -C "$SKILLS_DIR"

For example, to install into a Codex project instead:

SKILLS_DIR=.agents/skills

The table covers the common cases; consult your agent’s documentation (linked above) for the authoritative list of locations it scans. Both skills bundle a