svc-gpt 💬

The conversational surface of Generate One — multi-model chat with 9 MCP namespaces, RAG file search, and full platform tool access wired in by default.

---

✨ Overview

svc-gpt runs LibreChat v0.8.3 — the primary user-facing chat interface for Generate One. Every conversation connects to LiteLLM for multi-provider model routing, accesses 9 MCP namespaces through MetaMCP (knowledge graph, code, web search, project management, math, and more), and uses knowledge-mcp as a RAG compatibility layer for file search. Authentication is managed via Authentik OIDC SSO. Chat history, user accounts, agent configs, and presets are persisted in a self-contained MongoDB 8 instance.

⚠️ This service is tagged DO NOT DELETE — it contains production user data in MongoDB.

---

🏗️ Architecture

graph TB
    User["User Browser"] -->|"https://gpt.generate.one"| LC["LibreChat v0.8.3\n:3080"]

    subgraph svc-gpt ["svc-gpt (svc-gpt-legacy)"]
        LC
        MDB["MongoDB 8\n:27017"]
    end

    LC -->|"OpenAI-compatible API"| LLM["g1-llm / LiteLLM\nllm.generate.one"]
    LC -->|"MCP over SSE"| MM["svc-tools / MetaMCP\nmcp.generate.one"]
    LC -->|"RAG API"| KM["g1-brain / knowledge-mcp\n:8000"]
    LC -->|"OIDC SSO"| AK["svc-auth / Authentik\nauth.generate.one"]
    LC -->|"Chat data"| MDB

    subgraph MCP Namespaces
        NS1["g1-brain · 43 tools\nKnowledge · Reasoning · CMS"]
        NS2["g1-code · 112 tools\nForgejo API"]
        NS3["g1-web · ~15 tools\nSearXNG · Crawl4AI"]
        NS4["g1-project · 111 tools\nWorklenz PM"]
        NS5["g1-time · g1-math\ng1-presenter"]
    end

    MM --> NS1 & NS2 & NS3 & NS4 & NS5

---

📦 Services

Service	Image	Port	Description
librechat	ghcr.io/danny-avila/librechat:v0.8.3	3080	Chat UI with MCP + multi-model support, file upload, presets
mongodb	mongo:8	27017	Chat history, users, agent configs, presets, file metadata

Persistent Volumes

Volume	Mount	Purpose
librechat-images	/app/client/public/images	Uploaded and generated images
librechat-uploads	/app/uploads	File uploads for RAG
librechat-logs	/app/api/logs	Application logs
mongodb-data	/data/db	MongoDB persistent data

---

🚀 Quick Start

# Service directory
cd /data/coolify/services/hg0wswsc4k8o8ww8ckw4owog

# Apply changes
docker compose up -d

# View LibreChat logs
docker compose logs -f librechat

# LibreChat config changes require restart
docker compose restart librechat

# Inspect MongoDB
docker exec -it mongodb-hg0wswsc4k8o8ww8ckw4owog mongosh librechat

Key Endpoints

Endpoint	Purpose
https://gpt.generate.one	Chat UI
https://gpt.generate.one/api/	LibreChat REST API

---

🔧 Configuration

Variable	Description	Notes
OPENAI_API_KEY	LiteLLM API key for model access	Prefix: sk-
OPENAI_REVERSE_PROXY	LiteLLM endpoint	https://llm.generate.one/v1
ALLOW_SOCIAL_LOGIN	Enables Authentik OIDC SSO	true
RAG_API_URL	knowledge-mcp endpoint for file search	Internal URL
MONGO_URI	MongoDB connection string	Internal container
CONFIG_PATH	LibreChat config file path	/app/librechat.yaml
CREDS_KEY	Credential encryption key	Must not change
JWT_SECRET	JWT signing secret	Must not change

Config Files

File	Purpose
librechat.yaml	Model specs, MCP namespace registrations, agent configs, RAG settings
.env	Environment variables (OIDC credentials, API keys, URLs)

---

🤖 Model Tiers

LibreChat connects to LiteLLM which routes to the appropriate backend:

Model Key	Purpose
g1-llm	General-purpose LLM (default)
g1-llm-turbo	Reasoning model
g1-llm-mini	Lightweight / fast model
g1-llm-code	Code-optimized model
g1-vlm	Vision-language model
g1-llm-pro	Premium tier
g1-llm-code-pro	Premium code tier
g1-llm-micro	Local 8B model (vLLM, RTX 5090)

---

🔌 MCP Integrations

LibreChat connects to 9 MCP namespaces via MetaMCP (mcp.generate.one):

Namespace	Tools	Purpose
g1-brain	43	Knowledge graph, skills, reasoning, constraint solving, Directus CMS
g1-code	112	Forgejo repository operations
g1-web	~15	Web search (SearXNG) and scraping (Crawl4AI)
g1-project	111	Worklenz PM — tasks, time tracking, reporting
g1-time	5	Current time, timezone conversion
g1-math	~30	Symbolic mathematics (SymPy)
g1-presenter	4	Slide presentation creation

---

🔗 Dependencies

Depends On

• g1-llm — LiteLLM for model routing (llm.generate.one)
• svc-tools — MetaMCP for MCP tool access (mcp.generate.one)
• g1-brain — knowledge-mcp for RAG file search
• svc-auth — Authentik for OIDC SSO

Depended On By

• End users — Primary chat interface for all platform interactions

---

🗂️ Quick Reference

Item	Value
Domain	gpt.generate.one
Coolify Project	svc-gpt-legacy
Coolify Service UUID	hg0wswsc4k8o8ww8ckw4owog
Compose Path	/data/coolify/services/hg0wswsc4k8o8ww8ckw4owog/
LibreChat Version	v0.8.3
OIDC Issuer	https://auth.generate.one/application/o/librechat

---

🛡️ Part of Generate One

Generate One — AI infrastructure that answers to you.

Sovereignty First · Composable · Open by Default · Developer Empathy

Self-hosted, sovereign AI platform. generate.one