The manual
01Start
What PremAgentic isWhat PremAgentic does, the claim it makes about the network and how that claim is tested, what setup needs once, and what it does not do.
Getting startedFrom a fresh clone to a cited answer, with the access gate proven, in the first ten minutes.
Connect an assistantHow an assistant connects over MCP with an agent token, what it can reach, and the portal's connect page where a person does it for themself.
02How it decides
AccessHow who may read a document is decided: ordered access lists and folder rules, agents and where their models run, and the second line of access control in the database.
Lifecycle, trust and freshnessThe lifecycle, trust and freshness gates, Open Knowledge Format frontmatter, undeclared authorship in a bundle, and the review queue.
AdministrationThe administration portal, every setting in one catalog, the change record, the audit trail with its usage page, self-serve agents, reminders, with screenshots.
03Operate
InstallingInstalling on a PostgreSQL you already run, the roles and files setup makes, HTTPS from the first start, the bundled PostgreSQL on Windows, and installing from an archive built from the source.
Running itRunning the API as a Windows service or a systemd unit, and what to set behind a reverse proxy.
Upgrading and removingHow to upgrade and roll back, and how prem remove takes away the services with or without the data.
ConfigurationThe environment variables every host reads, their defaults, and what switching the embedding provider means.
The authorization flowThe MCP authorization flow, built and off by default: what turning it on takes, what off means, how an assistant registers and a person approves it, how a grant ends, and the settings.
StoragePlain PostgreSQL with no extension, the two schemas and their promises, migrations, the audit trail, and the vectors held in memory.
04Extend
Sources, readers and chunkersRegistering a folder as a source with its owner and hosted-model switch, the readers that read its files and the chunkers that cut them, and what a run did not read.
ExtensionsHow a reader, a chunker, an embedding provider or a way of signing in is added from a folder, allowed by hash with every file it loads, and refused with a reason.
Writing an extensionA walkthrough for writing an extension, proving it with the conformance kit, and allowing it in a deployment.
ConnectorsThe IDocumentSource extension point and the filesystem reference connector.
ProfilesA folder of plain files carrying a whole configuration, validated as a whole, applied as a whole, and compared with a deployment.
Tuning and the golden setThe retrieval settings that are per deployment, how to judge a change with the golden set, and why the golden set is the deliverable.
05Reference
SurfacesThe projects in the repository, the three ways a caller reaches the HTTP surface, the portal's pages, agents over MCP, and your own words on the tools.
The prem commandEvery prem command with its arguments and options, as the program prints them.
Measuring it yourselfThe benchmark in the repository: what it times, how to run it on a throwaway database, and why every number depends on the machine.
Known stateWhat is built and tested, how the guards were checked, what the clean-install script and the archive proofs show, and what is not built.
RoadmapWhat comes next for PremAgentic.