Grounded agents that actually know what they're talking about.

Q. What is Radioso?

Radioso is a self-hosted context platform for grounded assistants. You upload your documents and Radioso parses, chunks, and embeds them into Postgres with pgvector1. From there, one backend powers a web chat, a REST API, a TypeScript SDK, a website embed, and an MCP server — so the same grounded answers reach your end users and your tools2. The data and the model keys stay in your stack3.

Sources1docs/retrieval.md· § pgvector2docs/architecture.md· § Surfaces3docs/deployment.md· § Self-hosting
Answered by Radioso· grounded in this site's knowledge base

Self-hosted

Runs on your own infrastructure

Bring your own LLM

Your keys, no inference markup

Your data stays put

Everything in your Postgres

Open standards

MCP, REST, and SDK included

Inside Radioso.

Assistant

one turn loop · steer, act, follow through

Directives

steer
confirm before acting
stay concise
+ your rules

Standing condition → action rules. Shape behavior, no new capability.

Skills

act

retrieval.answer

ground answers in your docs

Your own

register a capability

retrieval draws on your docs → Postgres + pgvector

Routines

guide

Contact a human

collect → confirm → send

Your own

author a journey

Stateful multi-step journeys, resumed across turns.

LLM
Grounded answer + citations·async actions (outbox)
Web chatPublic chatWebsite embedREST APITypeScript SDKMCP server

Ask from any surface — the answer returns there.

Follows your rules. Runs your skills. Knows your content.

Working assistant in under five minutes.

The bootstrap script prompts for your AI provider credentials, generates secrets, and starts the full stack with Docker Compose. Register, upload a document, ask a question.

~/radioso
# requires Node 24 + Docker Desktop
./run-dev.sh

# then open
# http://localhost:3000   web app
# http://localhost:8080   API