Platform overview
What OrcAI is, who it is for, how retrieval-backed chat works, and the main areas of the app with their paths.
OrcAI lets organisations build bots that answer from their own material and cite their sources. It originated in the SokratesT project and still supports learning workflows where instructors curate sources and students interact with a grounded AI tutor. Beyond that fixed instructor-student model, individuals and groups can build specialised repositories and bots for their own domains.
What OrcAI does
- Members upload files to the Library, and OrcAI prepares them as assets.
- Repositories group assets, and behaviours set how a bot writes.
- A bot combines one behaviour with its repositories and features such as web search or questions and quizzes.
- When someone asks a bot a question, it searches its repositories for matching passages and cites them in its answer.
A chat can also run on a model alone, without a bot.
Behind this, background workers read the files, an embedding model indexes them in Qdrant, and the organisation's chat models write the answers. See Self-hosting for the services an instance runs.
Core areas
- Home (
/app): the start page after sign-in, with a Use tab (/app?view=use) for asking questions and a Manage tab (/app/manage) with an overview of the organisation and, for admins, its readiness checklist. - Chat (
/app/chat): AI chats, optionally started from a bot. - Library (
/app/library): everything the organisation can use, browsed by kind (Bots, Behaviours, Repositories and Assets) from one rail, with search, filters and a Mine switch. It is one item in the sidebar. - Catalogue (
/app/catalogue): the bots, behaviours and repositories that organisations on this instance have listed, to preview and add to your organisation. It is the sidebar item after Library. - OrcAI Assistant (
/app/assistant): the built-in helper for questions about your work and about OrcAI. - Access control: organisations, roles, groups, invitations and sharing.
- Administration: Members, Groups, Quota pools, Analytics, Providers, Models and Organisation for the active organisation, shown to members whose role allows them.
- Instance management (
/instance): health, organisations and accounts across the whole instance, for instance admins.
Suggested reading
Start with chat
Start chats, choose bots and attach sources.
Set up an organisation
Prepare providers, models, quota pools, assets, bots and members.
Run it locally
Start a local Compose stack and see which services OrcAI needs.
Getting access
The managed OrcAI service is open only by invitation from someone already on the instance. To create your own organisation and invite people yourself, contact us at sokratest@hochschule-rhein-waal.de.
OrcAI documentation
Entry point to the OrcAI documentation, with the main capabilities and links to usage, self-hosting and development guides.
First steps
The first steps as a new member who joins an organisation by invitation, and as the person who initialises a new OrcAI instance and prepares its first organisation.