Author SHA1 Message Date
inference-bot 34ade7a882 docs(agentic-systems): cover the whole agent fleet, not one bot 2026-11-21 16:39:59 +00:00
inference-bot 6183ac3f73 Merge pull request 'docs: make the Tinfoil encryption boundary precise' (#19) from docs/privacy-guide-precision into main 2026-11-21 16:26:23 +00:00
inference-bot 7e4ed4fac9 docs: make the Tinfoil encryption boundary precise
The gateway handles the prompt in memory before the Tinfoil proxy encrypts
it; say that, rather than implying the co-op never sees plaintext.
2026-11-21 16:26:16 +00:00
inference-bot e582a37c29 Merge pull request 'docs: gather privacy posture in one member-facing page' (#18) from docs/what-happens-with-your-data into main 2026-11-21 16:24:18 +00:00
inference-bot be0ca6c53b docs: gather privacy posture in one member-facing page
Adds guides/what-happens-with-your-data.md covering what the gateway,
chat server and each provider keep, why the routing path differs from a
marketplace router, and what the co-op does not claim.

Links it from Models, API access, Getting started, Guest access,
Infrastructure, the docs index, README and privacy policy. Fixes Getting
started's temporary-chat claim: temporary chats are server-backed and
deleted about an hour after creation, not never stored.
2026-11-21 16:24:00 +00:00
inference-admin 8d002bf5bc Merge pull request 'Document the agent-host access model' (#17) from docs/host-access-model into main
Reviewed-on: #17
2026-11-21 16:14:01 +00:00
inference-bot cb270e51b9 docs: document the host access model
State the privilege ranking on the Agentic Systems page: bots have no sudo, the steward can act only inside bot accounts, and root belongs to a separate key-only operator account. Update the Infrastructure page's least-privilege and backup statements to match.
2026-11-21 16:08:20 +00:00
inference-admin afbac0d805 Tweaks to the Working Group page 2026-11-20 05:12:45 +00:00
inference-admin 36d2d3c837 Added the approved Community WG description 2026-11-20 05:11:00 +00:00
inference-bot a9df31b287 docs: add Working Groups section under Operations, with Community page 2026-11-20 05:03:42 +00:00
inference-admin 695c6cfcf3 docs: keep infrastructure page navigational, not implementation detail 2026-11-20 02:12:31 +00:00
inference-admin 5ec2504426 docs: reflect restricted host access, signed key feed, backup versioning, advisory CI 2026-11-20 02:10:58 +00:00
inference-admin 20477174e5 security: hash-lock the docs build toolchain 2026-11-19 23:55:59 +00:00
inference-admin 279886fd83 security: use Gitea regexp CODEOWNERS rules 2026-11-19 23:52:30 +00:00
inference-admin eaaa615c73 security: CODEOWNERS for the publishing path and CI config 2026-11-19 23:52:03 +00:00
inference-bot 7dd072d245 Merge pull request 'docs(search): page fetching runs on co-op infrastructure' (#16) from search-fetcher into main 2026-11-19 23:07:32 +00:00
inference-admin 55f232e172 docs(search): page fetching runs on co-op infrastructure, not a third party 2026-11-19 23:07:06 +00:00
inference-bot 1f23ea1d78 Merge pull request #14: docs(search): describe the search and fetch pipeline 2026-11-19 22:36:44 +00:00
inference-admin a705a49495 ci: docs pipeline is secret-free and builds in an ephemeral venv; policy: untrusted text is data 2026-11-19 22:19:27 +00:00
inference-admin 5c23ec9310 Removed unnecessary index 2026-11-19 22:02:30 +00:00
inference-admin b39c9b9289 publishing: build without credentials, publish from a host-owned script
Repo build logic now runs as the unprivileged docsbuild user with a scrubbed
environment; the Cloudron token lives only in a root-owned publish script that
executes no repository code.
2026-11-19 21:51:05 +00:00
inference-admin f2e74564df Merge pull request 'Add guide: using the co-op privately from a local chat app' (#15) from bengansky/docs:local-chat-apps-guide into main
Reviewed-on: #15
Reviewed-by: Admin <info@inference.coop>
2026-11-19 21:32:03 +00:00
bengansky 03d32d2356 Add local chat apps guide to nav 2026-11-19 20:11:54 +00:00
bengansky 2ccf793644 Add guide: using the co-op privately from a local chat app
Walk-through for going from zero (no IC account/membership) to using IC-provided models on your own device (desktop or phone) via local apps.
2026-11-19 20:07:19 +00:00
ed b0edbf2c33 docs(search): describe the search and fetch pipeline
Explain the two stages: SearXNG queries DuckDuckGo and Brave, then Keenable fetches the top result pages. Name the SearXNG instance URL and disclose Keenable's logging, retention, processing location, and training use. Correct the claim that web search has no external dependency.
2026-11-19 14:29:13 -05:00
inference-bot 0896699581 privacy: phrase temporary-chat retention as minimal, defer details to infrastructure 2026-11-19 16:07:39 +00:00
inference-bot 606bfc5660 privacy/infra: document brief temporary-chat retention and DuckDuckGo + Brave search 2026-11-19 16:03:46 +00:00
inference-admin 1ec63c443b docs(models): stable EUR list prices for GreenPT and Regolo; USD billed at the ECB daily rate
Members see provider list prices in EUR (which don't move with FX) and a note that
the dollar figure is computed daily, matching the gateway's boot-time FX sync.
2026-11-18 17:58:20 +00:00
inference-admin 122a2bda4e docs(roles): add usernames, sort the GM into the mix, consolidate policy links
Holders carry their Matrix handles. Rows are alphabetical by first name, so the GM
sits between Juan and Tara. Working-group names are plain text (links come when the
groups are formally approved); the Steward Policy is linked once, from the Basis
column, and the GM's policy link moved there from the Role cell.
2026-11-17 23:28:29 +00:00
inference-admin 4974469ee2 docs(roles): add four working-group stewards appointed 17 November 2026
Isabela Barbosa (Community), Juan Fortun (Design), Angel Marino (Infrastructure &
Engineering), Tara Merk (Compute) — first-name alphabetical, each linking the
Steward Policy; basis: appointed by the General Manager.
2026-11-17 23:24:22 +00:00
dariusk 03b1772eaf Clarify privacy limitations of Tinfoil (#12)
Co-authored-by: Darius Kazemi <darius.kazemi@gmail.com>
2026-11-17 21:56:57 +00:00
inference-admin e50c4837c2 Fixed typo 2026-11-17 08:49:28 +00:00
inference-admin 9037d56533 Simplified guest info 2026-11-17 08:48:33 +00:00
inference-admin 7ef466477a Clarified guest conversion to membership 2026-11-17 08:47:28 +00:00
inference-admin 26c37facf3 Pricing narrative framing 2026-11-17 08:38:27 +00:00
inference-admin ab30b55f5c docs(pricing): 'priced at what the co-op pays providers' — no claim of an exact pass-through 2026-11-17 08:30:29 +00:00
inference-admin 47fdfafea5 docs(pricing): say what the credits are — provider cost passed through, dues cover the rest
Opener states that usage credits cost exactly what the co-op pays providers (linking
Models), and that contributions beyond usage cover expenses. Dues line now says 'pay
what you expect to use, or more if you want to support the co-op'. Cut the
dues-and-allowance paragraph; Guest access links to its own page.
2026-11-17 08:29:02 +00:00
inference-admin 64bce40212 docs(charter): code-of-conduct link is a sibling, not one level up 2026-11-17 08:17:31 +00:00
inference-admin 706a5d4681 docs(charter): sibling links to ToS and privacy policy 2026-11-17 08:17:11 +00:00
inference-admin 4272246abf docs(tos): privacy policy lives beside the ToS, not one level up — three links fixed 2026-11-17 08:16:55 +00:00
inference-admin 9019afddaf docs(pricing): relative link to the charter 2026-11-17 08:15:18 +00:00
inference-admin 019b9f5782 docs: a Pricing page that states practice; drop the invented 'suggested' level and the bot bullet
- guides/pricing.md: dues from $5/month with no suggested level, the flat $15 monthly
  allowance, credit packs (applied for members, held/refunded otherwise), the 7-day
  grace and pause-not-removal practice, guest access.
- getting-started: removed 'the suggested level is $15' — we do not set one.
- open-questions: no longer the place facts live; points at Pricing.
- homepage: bot bullet removed; Pricing added to Start here and the nav.
2026-11-17 08:14:06 +00:00
inference-admin ac8cac02c6 docs: reorganise into Guides / Operations / Governance
- Guides/: getting started, guest access, models, API access, energy & carbon
- Operations/: agentic systems (was 'working with the agent'), infrastructure, roles, steward policy
- Governance/: unchanged, now with its overview page
Lateral links and the homepage updated; redirects keep the old root URLs alive.
2026-11-17 00:04:24 +00:00
inference-admin a6142d68f2 A bit more language on role doc 2026-11-16 23:47:07 +00:00
inference-admin 7ad102e70d roles: minimal table; 'general manager' links to the charter's Roles section
Dropped the role description (it belongs in the charter), the role-changing note
(not all roles are governance-determined — the charter lets the GM set some), and
the voting-member figure, which was wrong.
2026-11-16 23:42:30 +00:00
inference-admin 425cfa7078 docs: Roles page under Operations — general manager, approved 30 October 2026
Records the membership poll that formally approved Nathan Schneider as general
manager (closed 2026-10-30, 74 members voting), what the role does, and how roles
are added or changed. Linked from the Operations index and the nav.
2026-11-16 23:32:13 +00:00
inference-admin 1ec9657f85 Added approval date to steward policy 2026-11-16 23:22:34 +00:00
inference-admin 306b83eaa7 docs: an Operations section, the approved Steward Policy, and section index pages
The Steward Policy passed in Loomio, so it lands as operations/steward-policy.md
(verbatim from the shared draft, one garbled phrase repaired: 'finances alloas
determined by' -> 'finances allow, as determined by').

Governance and Operations now have index pages, and both are in the nav as
section overviews, so each section has a landing page instead of a bare menu.
2026-11-16 23:20:05 +00:00
inference-admin 01e18a9f8b models: the default now serves the DeepSeek V4.1 Flash 1017 snapshot
Same name, new snapshot and new rates ($0.36/$1.45/$0.04 per 1M). The id is unchanged
on purpose: 3,014 calls in two days used it, so renaming would break members' configs.
2026-11-16 15:53:13 +00:00
inference-admin 6a5acc2b82 api-access: glm-green is glm-flash-green
Same-model-two-routes reads better when both names carry the tier.
2026-11-14 18:57:48 +00:00
inference-admin 481a9f40cd api-access: -green/-tee aliases, and a table of where they point today
Names now say which route rather than how fresh a version is, and the page
answers the question the names raise: what each alias serves right now.
2026-11-14 18:47:56 +00:00
inference-admin 7f8480f13d api-access: the typical model entry uses the stable aliases
The gateway now serves four version-free names (deepseek-flash-latest,
glm-flash-latest, deepseek-flash-tee, glm-tee), added per co-op/support#47 so a
member's config survives a provider retiring a version. The example entry is what
members copy, so it should be the names that keep working; provider-prefixed ids
still work and are linked for anyone who needs a specific version.
2026-11-14 18:42:47 +00:00
32 changed files with 1607 additions and 311 deletions

No files matched your search

+22 -40
View File
@@ -1,33 +1,25 @@
# Woodpecker CI pipeline for co-op/docs — THIN on purpose.
# Woodpecker CI pipeline for co-op/docs — THIN and SECRET-FREE on purpose.
#
# It does NOT re-implement the build. The repository's publishing layer is the
# single source of truth and this pipeline only wires it up:
# It does NOT deploy. Publishing is host-side and split:
#
# publishing/requirements.txt pinned MkDocs + Material toolchain
# publishing/build.sh stage Markdown -> .site-src/, render .site-build/
# publishing/deploy.sh push .site-build/ into the Cloudron Surfer app
# /usr/local/sbin/docs-poll host-owned poller (root) — pulls main
# publishing/build.sh runs as the unprivileged `docsbuild` user,
# with no credentials and no access to
# /home/ubuntu
# /usr/local/sbin/docs-publish root-owned publish step — runs no repo code,
# holds the Cloudron token from a root-only file
#
# Any change to how the site is built belongs in publishing/, never here.
# CI exists only to prove the repository builds. It runs in a throwaway venv
# inside the pipeline workspace, never the agent image's shared /opt/docs-venv:
# a push to ANY repo must not be able to change a toolchain that another
# pipeline uses. No secret is wired into this pipeline, and none should be
# until the Woodpecker agent supports per-pipeline isolation.
#
# Run model: MANUAL ONLY for now. The Gitea webhook that fires this on push is
# deliberately NOT wired — the poll watcher (docs-deploy-poll.service on the
# agent host) remains the live auto-deploy path until a manual run has proven
# the pipeline. Once it has, add `push` to the `when` block below and register
# the webhook in Gitea.
#
# Backend note (IMPORTANT — this is why there are no container images here):
# The co-op's Woodpecker agent runs as a Cloudron app, which has no Docker
# socket, so it uses Woodpecker's `local` backend. Under `local` each step is
# run as a shell command INSIDE the agent container, and the step's `image:`
# field selects the SHELL, not a container image. Every tool the steps need is
# therefore baked into the agent image (co-op/woodpecker-agent):
# python3 + the pinned MkDocs toolchain (venv at /opt/docs-venv, mirroring
# publishing/requirements.txt), node + the cloudron CLI, bash, git, tar.
# If the toolchain pin changes, rebuild that image — see its Dockerfile.
#
# Secrets required (Woodpecker repo secret, name `cloudron_token`):
# cloudron_token = the Cloudron API token used by publishing/deploy.sh
# Do not put credentials in this file.
# Backend note: the co-op's Woodpecker agent is a Cloudron app with no Docker
# socket, so it uses Woodpecker's `local` backend. Each step runs as a shell
# command INSIDE the agent container; the `image:` field selects the SHELL, not
# a container image. That is exactly why this file must stay secret-free: the
# container is shared by every pipeline.
when:
- event: manual
@@ -36,17 +28,7 @@ steps:
- name: build
image: bash
commands:
# Reuses the toolchain pre-installed in the agent image; build.sh only
# creates/installs a venv if the one given is missing, which it is not.
- publishing/build.sh /opt/docs-venv
- name: deploy
image: bash
commands:
# deploy.sh drives the Cloudron `cloudron` CLI (a node program) via
# `cloudron exec`; node, the CLI, bash, git and tar are all in the agent
# image. The build it publishes is the shared workspace .site-build/.
- publishing/deploy.sh
environment:
CLOUDRON_TOKEN:
from_secret: cloudron_token
# Ephemeral toolchain per run — no shared venv, no /opt/docs-venv.
- python3 -m venv .ci-venv
- .ci-venv/bin/pip install -q --require-hashes -r publishing/requirements.txt
- publishing/build.sh .ci-venv
+8
View File
@@ -0,0 +1,8 @@
# Critical publishing path for the docs site.
# A change here runs repository code during the build (publishing/hooks.py,
# build.sh) and controls what gets deployed. Require an Owners review before
# merge — CODEOWNERS review enforcement is enabled on main.
# Gitea CODEOWNERS uses Go regexp (not glob); anchor each rule.
^publishing/.* @co-op/owners
^mkdocs\.yml$ @co-op/owners
^\.woodpecker\.yml$ @co-op/owners
+7 -6
View File
@@ -10,13 +10,14 @@ funded through our [Open Collective](https://opencollective.com/inference-cooper
## Start here
- **New here?** → [Getting started](getting-started.md) — join, use the chat, and get involved in governance.
- **New here?** → [Getting started](guides/getting-started.md) — join, use the chat, and get involved in governance.
- **Why does this exist?** → [Background](background.md) — a one-page summary of the mission and history.
- **Which models can I use?** → [Models](models.md) — the full catalog of providers and models.
- **Want API access?** → [API access](api-access.md) — use our models programmatically.
- **Want community chat?** → [Getting started · Matrix](getting-started.md) — our federated Matrix server, including how to connect from any client and how to use an existing Matrix account.
- **Curious how it works?** → [Infrastructure](infrastructure.md) — a map of the stack and the codebase.
- **Wondering about the bot?** → [Working with the agent](working-with-the-agent.md) — what the co-op's agents do, who can instruct them, and what always needs a human.
- **Which models can I use?** → [Models](guides/models.md) — the full catalog of providers and models.
- **What happens to my data?** → [What happens with your data](guides/what-happens-with-your-data.md) — what the gateway, the chat server and each provider keep.
- **Want API access?** → [API access](guides/api-access.md) — use our models programmatically.
- **What does it cost?** → [Pricing](guides/pricing.md) — dues, the monthly allowance, credit packs and what happens if dues stop.
- **Want community chat?** → [Getting started · Matrix](guides/getting-started.md) — our federated Matrix server, including how to connect from any client and how to use an existing Matrix account.
- **Curious how it works?** → [Infrastructure](operations/infrastructure.md) — a map of the stack and the codebase.
- **Need help or have an idea?** → [Support & feature requests](https://git.inference.coop/co-op/support) — open an issue.
## Key links
+1 -1
View File
@@ -9,7 +9,7 @@ together.
We are a small cooperative by design, fiscally sponsored by the nonprofit
[Metagov](https://metagov.org) and managing member dues on
[Open Collective](https://opencollective.com/inference-cooperative).
For how to join and use it, see [Getting started](getting-started.md);
For how to join and use it, see [Getting started](guides/getting-started.md);
for our governance model, see the [Charter](governance/charter.md).
## How we got here
+3 -3
View File
@@ -41,9 +41,9 @@ We regard disputes as an opportunity to learn and grow. Members should try to wo
This charter is the core governing document. Members are also bound by the following agreements:
* [Code of Conduct](../code-of-conduct.md)
* [Terms of Service](../terms-of-service.md)
* [Privacy Policy](../privacy-policy.md)
* [Code of Conduct](code-of-conduct.md)
* [Terms of Service](terms-of-service.md)
* [Privacy Policy](privacy-policy.md)
## Legal entity
+14
View File
@@ -0,0 +1,14 @@
# Governance
How the co-op decides things, and the agreements members share.
## In this section
- [Charter](charter.md) — the co-op's founding agreement
- [Code of conduct](code-of-conduct.md) — what we expect from each other
- [Terms of Service](terms-of-service.md) — the agreement covering use of the service
- [Privacy Policy](privacy-policy.md) — what we collect and why
- [How to make a proposal](make-a-proposal.md) — the path from an idea to a decision
- [Open questions](open-questions.md) — matters the co-op has not settled yet
Operational roles sit in [Operations](../operations/).
+1 -1
View File
@@ -33,7 +33,7 @@ Currently chat history is stored on co-op servers. We could potentially switch t
### How should pricing account for unequal usage?
Members currently pay dues on a sliding scale (from $5/month) with a flat $15/month credit budget. But usage is unequal — some members use far more tokens than others.
Dues and the shared monthly credit budget are set out in [Pricing](../guides/pricing.md). Usage is unequal — some members use far more tokens than others.
- **Flat (current):** simple, predictable, but heavy users subsidize light users (or vice versa).
- **Usage-based:** pay for what you use, but unpredictable and may discourage experimentation.
+31 -8
View File
@@ -12,6 +12,9 @@
The full policy is below. Questions? info@inference.coop.
For a page-by-page account of what the gateway, the chat server and each
provider keep, see [What happens with your data](../guides/what-happens-with-your-data.md).
---
## 1. Our privacy philosophy
@@ -43,7 +46,7 @@ Your **chat history is stored on our server** so you can revisit past conversati
We commit not to read it. But this is a **policy commitment**, not an architectural guarantee. We're transparent about this distinction because it matters.
Note the boundary precisely: enclave models protect your conversation **while it is being processed** — the model provider and we cannot read the exchange at inference time. Stored history is a separate leg: once a conversation is saved, it sits on our server in a form we can technically read. So for sensitive material, the strongest combination available today is a **Temporary Chat with an enclave model** — protected in transit and at inference, and never stored afterwards.
Note the boundary precisely: enclave models protect your conversation **while it is being processed** — the model provider and we cannot read the exchange at inference time. Stored history is a separate leg: once a conversation is saved, it sits on our server in a form we can technically read. So for sensitive material, the strongest combination available today is a **Temporary Chat with an enclave model** — protected in transit and at inference, and deleted shortly afterwards.
### If you use the API, nothing you send is stored
@@ -71,7 +74,7 @@ it is:
The chat has a **Temporary Chat** mode designed exactly for this:
- Click the **Temporary Chat** toggle in the chat header, and the conversation is **never saved** — it doesn't appear in your history, it isn't written to our database, and it disappears when you leave the page.
- Click the **Temporary Chat** toggle in the chat header, and the conversation is hidden from your history. It still exists on our server while you use it, so the chat can work; we retain temporary chats as minimally as possible and delete them automatically shortly after creation. It may remain in encrypted backups until those backups age out. Details are in [Infrastructure](../operations/infrastructure.md#chat-retention-and-web-search).
- To make this the default for every new conversation, open **Settings → Conversations** and enable **Default Temporary Chat**. The preference is stored in your browser, so it's yours to change at any time.
- The trade-off is that there's nothing to revisit: no history, no search, no sync across devices. Use it whenever that trade is right for you — you can mix saved and temporary conversations freely.
@@ -83,13 +86,31 @@ Our server software keeps standard operational logs (dates, error messages, and
## 5. Search
Web search runs through our self-hosted search instance. Search queries are forwarded to the underlying search engines (e.g. DuckDuckGo), which may see them. This is inherent to how web search works.
Our self-hosted **SearXNG** instance at
[search.inference.coop](https://search.inference.coop) handles web search. For
chat searches it forwards queries to **DuckDuckGo** and **Brave**; those
services receive the query from our server and may see it. Search queries and
results are part of the conversation record, so they follow that conversation's
retention: deleted when you delete a saved chat, or about an hour after a
Temporary Chat is created. Operational details are in
[Infrastructure](../operations/infrastructure.md#chat-retention-and-web-search).
To read the pages behind the results, our own page-fetch service fetches the
top result URLs. It runs on co-op infrastructure at fetch.inference.coop. The
service does not log the URLs or the page text and keeps no copy: the extracted
text goes to the model for that answer and is not stored by the fetcher. It
refuses private, loopback, and internal addresses, so it cannot be used to reach
our own network. Your chat messages and account identity stay with us.
Web search is optional. Leave the globe off for sensitive topics. Note that the
search engines in §7 still receive your query when you use it.
## 6. What we do NOT do
- We do **not** train models on your data.
- We do **not** sell, rent, or share your data.
- We do **not** use your data for advertising or profiling.
- We do **not** sell or rent your data.
- We do **not** share data for advertising or profiling. The service providers
in §5 and §7 process data to run the service.
## 7. Third parties
@@ -97,12 +118,13 @@ The models we serve are provided by third parties that change over time, each wi
- **Open Collective** — handles billing and membership (their own privacy policy applies).
- **Cloudron** — our self-hosted platform; no third-party cloud provider.
- **Search engines** — receive your search queries (see §5).
- **Search engines.** DuckDuckGo and Brave receive your search queries (see §5).
Page fetching runs on co-op infrastructure, not at a third party.
## 8. Retention and deletion
- Chat history is retained until you delete it.
- **Temporary chats are never retained** — they are not written to our database at all (see §4).
- **Temporary chats are retained as minimally as possible** — hidden from history immediately and deleted automatically shortly after creation. Details are in [Infrastructure](../operations/infrastructure.md#chat-retention-and-web-search).
- On leaving, your account is deactivated (data preserved for reactivation).
- You may request full deletion at any time: info@inference.coop.
@@ -110,7 +132,8 @@ The models we serve are provided by third parties that change over time, each wi
- Self-hosted on Cloudron (sandboxed apps, SSL, backups).
- Per-member API keys; access gated on live membership.
- No external dependencies for core infrastructure.
- Core infrastructure has no external dependencies. Web search sends queries
to the search engines named in §5; page fetching runs on co-op infrastructure.
## 10. Your rights
+6 -9
View File
@@ -1,6 +1,6 @@
# Terms of Service
**Last updated:** November 21, 2026
**Last updated:** October 6, 2026
## In plain language
@@ -38,7 +38,7 @@ We provide:
- **Web search** and **file uploads** within the chat interface.
- **Governance** — a seat in decisions about models, pricing, and direction.
Models are **not interchangeable in their affordances**. Each model has its own privacy, sustainability, and openness properties, and the set of available models changes over time. You are **responsible for assessing** which model fits your needs for a given task — in particular its privacy properties — before relying on it. See our [Privacy Policy](../privacy-policy.md) for what this means in practice.
Models are **not interchangeable in their affordances**. Each model has its own privacy, sustainability, and openness properties, and the set of available models changes over time. You are **responsible for assessing** which model fits your needs for a given task — in particular its privacy properties — before relying on it. See our [Privacy Policy](privacy-policy.md) for what this means in practice.
The service is provided **"as is"** and may change as the project evolves. We do not guarantee uptime or specific performance at this stage.
@@ -55,12 +55,10 @@ You agree not to use the service to:
- Use AI outputs as the **sole basis for consequential decisions** — legal, medical, financial, employment, housing, or safety-critical — without appropriate human review and professional oversight.
- Use the service for **high-risk or fail-safe** applications (e.g. critical infrastructure, life-support, weapons systems).
- Attempt to circumvent usage limits, the privacy architecture, or rate limits.
- Share your account credentials.
- Share your account credentials, or resell or redistribute access to the service.
You are **responsible for what you submit and what you do with AI outputs**, and you must have the rights needed to submit your content.
You may use the service to provide a service of your own, as long as your use remains subject to these Terms, along with the acceptable-use and privacy expectations in §4 and §7.
## 5. Usage limits
- Membership includes a **monthly credit budget** (currently $15 of usage, the same for every member regardless of what you pay).
@@ -75,18 +73,17 @@ You may use the service to provide a service of your own, as long as your use re
- Your prompts and the AI's outputs are yours to keep.
- We do **not** train models on your data.
- We do **not** sell or share your content.
- See our [Privacy Policy](../privacy-policy.md) for how your data is handled.
- See our [Privacy Policy](privacy-policy.md) for how your data is handled.
## 7. Privacy
Privacy is a core value, but it is **not uniform across the service** — and the set of available models changes over time. Models differ in their privacy affordances: some run inference in encrypted enclaves so inputs and outputs are not readable in plaintext at the inference step, while others are selected for renewable energy or openness rather than architectural privacy. **You are responsible for assessing each model's privacy properties and choosing one that matches your needs.** See the [Privacy Policy](../privacy-policy.md) for the current picture.
Privacy is a core value, but it is **not uniform across the service** — and the set of available models changes over time. Models differ in their privacy affordances: some run inference in encrypted enclaves so inputs and outputs are not readable in plaintext at the inference step, while others are selected for renewable energy or openness rather than architectural privacy. **You are responsible for assessing each model's privacy properties and choosing one that matches your needs.** See the [Privacy Policy](privacy-policy.md) for the current picture.
## 8. Termination
- You may leave at any time by cancelling on Open Collective.
- On leaving, your account is deactivated (data preserved for reactivation). You may request full deletion.
- **If your dues stop**, we write to you before anything changes, and you then have a **seven-day grace period** in which your access continues. If no contribution arrives, your monthly allowance stops renewing and your access pauses until it resumes. Your account and your data stay in place.
- We may remove members per the Charter (Code of Conduct, continued non-payment).
- We may remove members per the Charter (Code of Conduct, non-payment).
## 9. Governance
+31 -6
View File
@@ -34,7 +34,9 @@ Two things worth being precise about:
[model list](models.md) distinguishes policy-based zero retention from
enclave-based protection.
Full detail, including what we can and cannot see: [privacy policy](governance/privacy-policy.md).
Full detail, including what we can and cannot see:
[What happens with your data](what-happens-with-your-data.md) and the
[privacy policy](../governance/privacy-policy.md).
## Get a key
@@ -98,7 +100,8 @@ endpoint configuration:
- **API type / protocol:** "OpenAI compatible" (or `openai-completions` where a
protocol string must be named) — not "Ollama", "Anthropic", or "Responses"
- **API key:** your member key (the `sk-…` string)
- **Model:** one from the [model list](models.md), e.g. `tinfoil/deepseek-v4-1-flash` or `greenpt/glm-5.3-flash`
- **Model:** a **stable alias** — `deepseek-flash-green`, `glm-flash-green`, `deepseek-flash-tee`, or `glm-tee`
— or any id from the [model list](models.md), e.g. `tinfoil/deepseek-v4-1-flash`
A typical provider entry looks like:
@@ -110,16 +113,38 @@ A typical provider entry looks like:
"api": "openai-completions",
"apiKey": "sk-your-key",
"models": [
{ "id": "tinfoil/deepseek-v4-1-flash" },
{ "id": "tinfoil/gpt-oss-120b" },
{ "id": "tinfoil/glm-5.3" },
{ "id": "greenpt/glm-5.3-flash" }
{ "id": "deepseek-flash-green" },
{ "id": "glm-flash-green" },
{ "id": "deepseek-flash-tee" },
{ "id": "glm-tee" }
]
}
}
}
```
The four names in `models` are **stable aliases**: we re-point them when a
provider retires or replaces a model, so a config that pins one keeps working
across transitions. The suffix says which route: `-green` is the default
(renewable energy, policy-based privacy), `-tee` serves the same family inside
attested hardware. Each alias is paired, so the two routes sit side by side in the
model list.
Pricing is set at the alias, so a transition that changes price appears in the
model list rather than arriving as a surprise. If you need one particular version,
use the provider-prefixed id from the [model list](models.md) instead.
Where the aliases point today:
| Alias | Serves today | Route |
| --- | --- | --- |
| `deepseek-flash-green` | `greenpt/deepseek-v4.1-flash` | Renewable energy; policy-based privacy |
| `glm-flash-green` | `greenpt/glm-5.3-flash` | Renewable energy; policy-based privacy |
| `deepseek-flash-tee` | `tinfoil/deepseek-v4-1-flash` | Confidential computing (TEE) |
| `glm-tee` | `tinfoil/glm-5.3` | Confidential computing (TEE) |
*Points as of 2026-11-14. We re-point these when a provider retires or replaces a
model; the alias names stay as they are, and this table changes with them.*
If a tool's own docs show a local-server example (e.g.
`baseUrl: http://localhost:11434/v1` with `api: "openai-completions"`),
substitute our base URL and your member key for `apiKey` — the protocol value
View File
File renamed without changes.
@@ -14,8 +14,7 @@ where we share dates and details. Check it for what's coming up.
## 1. Become a member
Membership is a **sliding-scale contribution starting at $5/month** through
Open Collective (the suggested level is $15 — pay what fits your
circumstances).
Open Collective (pay what fits your circumstances).
1. Go to [opencollective.com/inference-cooperative](https://opencollective.com/inference-cooperative).
2. Choose a contribution amount ($5 minimum) and subscribe.
@@ -57,8 +56,10 @@ with the account you created in step 1.
(GreenPT and Regolo, 100% renewable energy — Regolo adds a written
zero-data-retention policy). See the [model list](models.md) for the full
list.
- **Web search** — click the **globe** next to the message box to ground
answers in current web results (self-hosted search, no external dependency).
- **Web search.** Click the **globe** next to the message box to base answers
on current web results. Searches use our self-hosted SearXNG instance, and
pages are read by our own fetcher. See [what happens during a
search](#what-happens-when-you-use-web-search).
- **File uploads** — attach a document with the **paperclip** and ask the
chat about it.
- **Tools** — the **Tools menu** next to the message box lists everything the
@@ -66,13 +67,14 @@ with the account you created in step 1.
there's a tool you'd like available, ask in #general.
- **Voice** works in both directions: speak to the chat with the microphone
icon, and have replies read aloud.
- **Temporary chats** — for conversations you don't want kept on our servers
at all. Click the **Temporary Chat** toggle (in the chat header) and the
conversation is never saved: it disappears when you leave the page, and
nothing lands in your history or our database. To make this your default,
open **Settings → Conversations** and turn on **Default Temporary Chat**.
For anything sensitive, we recommend a temporary chat — ideally paired with
a 🔒 enclave model. See [Privacy](governance/privacy-policy.md#4-what-we-can-see-an-honest-caveat)).
- **Temporary chats** — for conversations you don't want in your history. Click
the **Temporary Chat** toggle (in the chat header): the conversation is hidden
from your history immediately and deleted from our database about an hour
after creation. It still reaches our server while the chat runs, and it can
remain in backups until they age out. To make this your default, open
**Settings → Conversations** and turn on **Default Temporary Chat**. For
anything sensitive, pair a temporary chat with a 🔒 enclave model. See
[What happens with your data](what-happens-with-your-data.md).
Your usage draws from your monthly allowance; you can see it on the
[Member Dashboard](https://dashboard.inference.coop).
@@ -85,6 +87,22 @@ see "Your allowance" below.
> — your full history is here in the new chat, but files you attached in the
> old one are still accessible only there.
### What happens when you use web search
Web search runs in two stages.
1. Our self-hosted **SearXNG** instance at
[search.inference.coop](https://search.inference.coop) sends your query to
**DuckDuckGo** and **Brave**.
2. LibreChat sends the top result URLs to the co-op's **own page fetcher**. It
reads each page and extracts its text. The model receives those passages,
and the answer cites the sources.
Both SearXNG and the page fetcher run on co-op infrastructure. The fetcher does
not log the URLs or the page text and keeps no copy. The
[privacy policy](../governance/privacy-policy.md#5-search) describes this. Web
search is optional. Leave the globe off if you do not want pages fetched.
### Add the chat to your phone
The chat works like an app on your phone — no app store needed. Open
@@ -156,17 +174,17 @@ privacy, and direction happen on our **Loomio forum**:
the co-op grows.
- The updates feed is posted by the co-op's automation account. See
[Working with the agent](working-with-the-agent.md) for the agents behind
[Working with the agent](../operations/agentic-systems.md) for the agents behind
it, what they do, and how members interact with them.
- See the [Charter](governance/charter.md) for how governance is structured.
- See [Open questions](governance/open-questions.md) for the decisions currently on the table.
- See the [Charter](../governance/charter.md) for how governance is structured.
- See [Open questions](../governance/open-questions.md) for the decisions currently on the table.
### Help build it
Everything we run is open source, and members are welcome to contribute code,
documentation, and design. See [Infrastructure](infrastructure.md) for the map
documentation, and design. See [Infrastructure](../operations/infrastructure.md) for the map
and the "Contributing" section for how to propose changes through
[git.inference.coop](https://git.inference.coop).
+5 -5
View File
@@ -24,21 +24,21 @@ card also lists the guests you've sent.
[dashboard.inference.coop](https://dashboard.inference.coop) showing what's
left.
- **The weekly newsletter** and these public docs.
- **The same privacy rules as members** — see
[What happens with your data](what-happens-with-your-data.md).
Guest access is not membership — no Matrix, governance forum, or vote.
## When it ends
When **the $2 is spent or the 60 days are up**, whichever comes first, your
friend gets an email saying so. Access stops; **the account and its data are
kept** — and a guest can end it early with the **Cancel guest access** link
friend gets an email saying so, and access stops. A guest can end it early with the **Cancel guest access** link
on their dashboard, returning any unspent credit to the co-op.
## Becoming a member
Contribute on
[Open Collective](https://opencollective.com/inference-cooperative/contribute)
and the account converts automatically — same login, same dashboard. Any
Guests can join the co-op on
[Open Collective](https://opencollective.com/inference-cooperative/contribute). As long as they use the same email address there, the account converts automatically — same login, same dashboard. Any
unspent guest credit carries over. See
[Become a member](getting-started.md#1-become-a-member) for how membership
works.
+13
View File
@@ -0,0 +1,13 @@
# Guides
How to join, use the chat, choose a model, call the API, and understand what that
usage costs in energy and emissions.
## In this section
- [Getting started](getting-started.md) — join, use the chat, and get involved in governance.
- [Guest access](guest-access.md) — inviting someone without a full membership.
- [Models](models.md) — the catalogue of providers and models.
- [What happens with your data](what-happens-with-your-data.md) — what the gateway, the chat server and each provider keep.
- [API access](api-access.md) — use the models programmatically.
- [Energy & carbon](energy.md) — the energy and emissions behind the service.
+200
View File
@@ -0,0 +1,200 @@
# Using the co-op privately on your phone or computer
## Why use a local app
*A step-by-step walkthrough for members who aren't developers/super technical. Whole process takes about 15 minutes. Drafted for [co-op/support#56](https://git.inference.coop/co-op/support/issues/56).*
The co-op's web chat keeps your conversation history on the co-op's server. If you'd rather keep that history on your own phone or computer, you can talk to the same co-op models from a chat app installed on your device. Any app that accepts a custom "OpenAI-compatible" connection will work. This guide uses two free examples: **Jan** for computers and **Chatbox** for phones and computers.
> **What changes, and what doesn't**
>
> - **Changes:** your chat history is saved on your device, not on the co-op's server.
> - **Doesn't change:** every message still travels through the co-op's gateway to the model provider (Tinfoil, GreenPT or Regolo), exactly as in the web chat. The co-op records usage (which model, how many tokens, the cost), not what you wrote.
> - **You give up:** the web chat's document search and image tool, and history that syncs between your devices. Each device keeps its own chats.
### Which app should I use?
| | Jan | Chatbox |
| --- | --- | --- |
| Runs on | Mac (Apple silicon), Windows, Linux | iPhone, iPad, Android, Mac, Windows, Linux |
| Connecting to the co-op | Finds the co-op's models for you | You may need to type model names in |
| Running open models on your own computer | Built in | Needs a separate app |
| Cost | Free, no paid plans | Free with your co-op key; also sells its own optional plans |
| Open source | Yes, Apache 2.0 | Community Edition is GPL-3.0 |
**Rule of thumb:** on a phone, use Chatbox. On a computer, either works; Jan is a little easier to connect.
### What you need
- A phone, tablet or computer from the table above
- An email address
- A card or account you can pay dues with on Open Collective
- About 15 minutes
## Part 1. Join the co-op (everyone)
### Step 1. Become a member
1. Go to [inference.coop](https://inference.coop) and click **Become a member**.
2. Open Collective opens with $5/month filled in. Dues are a sliding scale: pay $5, or more if you can. Every member gets the same $15 of usage each month, whatever they pay.
3. Finish the checkout.
> **Important:** use the same email address here that you'll use for your co-op login. That's how the co-op knows you're a member.
### Step 2. Create your co-op login
1. Within a few minutes you'll get a **welcome email**. Check spam if it doesn't arrive.
2. Click the link in it and create your username and password.
You can now log in to the web chat and the Member Dashboard.
### Step 3. Make your API key
An **API key** is a long password that lets an app use your membership. It starts with `sk-`.
1. Go to [dashboard.inference.coop](https://dashboard.inference.coop) and log in.
2. Find the API keys section and create a new key. Give it a name you'll recognise, like `Jan_on_my_laptop` or `Chatbox_on_my_phone`. A separate key for each device lets you switch one off without affecting the others.
3. **Copy the key now** and keep it somewhere safe, such as your password manager.
> **Treat the key like a password.** Anyone who has it can spend your monthly allowance. Don't paste it into email, chat or shared documents. If it leaks, delete it in the dashboard and make a new one.
Now continue with [Part 2A for Jan](#part-2a-jan-on-a-computer) or [Part 2B for Chatbox](#part-2b-chatbox-on-a-phone-or-computer).
## Part 2A. Jan on a computer
### Jan step 4. Install Jan
1. Go to [jan.ai](https://jan.ai) and download Jan for your computer.
2. **Mac:** open the downloaded `.dmg` file and drag Jan into Applications. **Windows:** run the `.exe` installer. **Linux:** use the Flatpak (`flatpak install flathub ai.jan.Jan`) or the `.deb`/AppImage.
3. Open Jan. On first launch it asks whether to share anonymous usage data. It's off unless you say yes; choose whichever you prefer.
Jan is free and open source (Apache 2.0). You don't need a Jan account.
### Jan step 5. Connect Jan to the co-op
1. In Jan, open **Settings** (the gear), then **Model Providers**.
2. Click **Add Provider**.
3. Fill in the **Add Custom Provider** box exactly like this:
| Field | What to enter |
| --- | --- |
| API format | **OpenAI-compatible** |
| Provider name | `Inference Co-op` |
| Base URL | `https://gateway.inference.coop/v1` |
| API key | your `sk-…` key from Step 3 |
4. Click **Create**.
Jan now asks the co-op which models you can use and lists them under the new provider. If the list is empty, click the **refresh** icon next to **Models**.
> **Check the Base URL.** It must end in `/v1`, with nothing after it. Don't add `/chat/completions`.
### Jan step 6. Turn on tool access
Jan can't tell what each co-op model is able to do, so it treats every co-op model as plain chat. Until you switch on **Tools**, a model can't use Jan's web search or other tools, even when it wants to. When that happens, the reply can get stuck repeating "Let me search the web…" over and over.
1. Go to **Settings → Model Providers → Inference Co-op**.
2. Click the **pencil** next to a model you plan to use.
3. Under **Capabilities**, switch on **Tools**. Switch on **Vision** too if the model can read images.
4. Repeat for each model you use. The [model table](#which-model-should-i-use) shows which models support what.
### Jan step 7. Say hello
1. Start a **New Chat**.
2. Click the model name above the message box and choose a model under **Inference Co-op**. Not sure? Start with `deepseek-flash-green`, the web chat's default. A **tools** label next to a model means step 6 worked.
3. **Optional: let it search the web.** Click the **globe icon** in the toolbar under the message box. It reads **Web Search (Active)** when on. Only models with Tools switched on can use it.
4. Type a message and press Enter.
If an answer comes back, you're done. Your conversation is saved on your computer, in Jan.
> **Where your searches go.** Jan's web search doesn't run through the co-op. By default it uses a search service called Exa, which needs no key. You can choose a different service in **Settings → Web Search**.
## Part 2B. Chatbox on a phone or computer
### Chatbox step 4. Install Chatbox
1. **iPhone or iPad:** search for *Chatbox AI* in the App Store. **Android:** search in Google Play, or download the APK from [chatboxai.app](https://chatboxai.app). **Mac, Windows, Linux:** download the installer from [chatboxai.app](https://chatboxai.app).
2. Open Chatbox.
3. If it offers to sign you up for **Chatbox AI**, skip it. That's Chatbox's own paid model service. You don't need an account or a plan to use your co-op key.
> **Two kinds of AI in one app.** Chatbox sells its own models (Lite, Pro and Pro+ plans). This guide uses only the co-op's models, paid for by your membership. When you pick a model, make sure it's one listed under your co-op provider.
### Chatbox step 5. Connect Chatbox to the co-op
1. Open **Settings**, then **Model Provider**. On a phone, Settings is in the side menu.
2. Scroll to the bottom and tap **Add**.
3. Fill it in exactly like this:
| Field | What to enter |
| --- | --- |
| Name | `Inference Co-op` |
| API mode | **OpenAI API Compatible** |
| API Host | `https://gateway.inference.coop/v1` |
| API Path | leave empty |
| API Key | your `sk-…` key from Step 3 |
4. Tap **Check** next to the API Key. It should report a successful connection.
5. Tap **Fetch** to load the co-op's models, then select the ones you want to use. If Fetch doesn't work, add a model by hand by typing its name exactly, e.g. `deepseek-flash-green`.
6. Save.
> **Check the API Host.** It ends in `/v1`, with nothing after it. Don't add `/chat/completions`.
### Chatbox step 6. Turn on images and tools
Chatbox treats a model as text-only until you tell it otherwise.
1. Go back to **Settings → Model Provider → Inference Co-op**.
2. Open a model's settings.
3. Turn on the capabilities it supports, such as **vision** for reading images and **tool use**. The [model table](#which-model-should-i-use) shows which models support what.
### Chatbox step 7. Say hello
1. Go back to the main screen and start a **new chat**.
2. Tap the model name and choose a model under **Inference Co-op**. Not sure? Start with `deepseek-flash-green`, the web chat's default.
3. Type a message and send it.
If an answer comes back, you're done. Your conversation is saved on this device, in Chatbox.
**Using more than one device?** Repeat these steps on each one, ideally with its own key. Chats don't move between devices.
## Which model should I use?
All co-op models draw from the same $15 monthly allowance. They differ in **privacy**, **energy** and **cost**. If you're adding models by hand, copy these names exactly.
| If you care most about… | Use this alias | What it is | Vision |
| --- | --- | --- | --- |
| A good all-rounder, renewable energy | `deepseek-flash-green` | The web chat's default model. Policy-based privacy. | ✓ |
| The same model with strong privacy | `deepseek-flash-tee` | Runs inside attested, encrypted hardware (confidential computing). Supports tools. | ✓ |
| Fast and inexpensive, renewable energy | `glm-flash-green` | A quick GLM model. Policy-based privacy. | |
| The strongest model, with strong privacy | `glm-tee` | GLM flagship in confidential computing. | |
These are the co-op's **stable aliases**. When a provider retires or replaces a model, the co-op points the alias at its successor, so your app keeps working without changes. The `-green` aliases run on renewable energy; the `-tee` aliases run the same model family in confidential-computing hardware. A blank Vision cell means the co-op doesn't document it. If you want a specific model instead, such as Regolo's zero-retention models, use its full name from the [models page](https://docs.inference.coop/guides/models/).
> **Which models can use tools (web search and other add-ons)?** Switch on Tools only for models that support it.
>
> - **Documented by the co-op:** `deepseek-flash-tee` (`tinfoil/deepseek-v4-1-flash`), `regolo/gemma4-31b` and `regolo/mistral-small-4-119b`.
> - **Worked in a member's test in Jan:** `greenpt/glm-5.3`, the strongest model in the green tier.
> - **Not documented yet:** `deepseek-flash-green`, `glm-flash-green` and `glm-tee`. Try them with Tools on; if you get errors or odd replies, switch Tools off for that model.
## Keeping an eye on your allowance
The [Member Dashboard](https://dashboard.inference.coop) shows how much of your $15 is left this month. Neither app shows it. The allowance resets on the day of the month you joined. If you run out, you can buy co-op credit packs, which never expire. You don't need Chatbox's own plans.
## If something goes wrong
| What you see | App | What it usually means | Fix |
| --- | --- | --- | --- |
| Error **401** or **403**, or Check fails | Both | The app isn't sending a valid key | Re-paste the key in the co-op provider's settings. Check there are no spaces at either end. |
| Error **404** on every message | Jan | The Base URL is wrong | Make it exactly `https://gateway.inference.coop/v1`. |
| Error **404** on every message | Chatbox | The API Host is wrong | API Host `https://gateway.inference.coop/v1` with API Path empty. If that still fails, try API Host `https://gateway.inference.coop` with API Path `/v1/chat/completions`. |
| No models listed | Jan | Jan couldn't fetch the list | Click the refresh icon next to Models, or click **+** and type a model name, e.g. `deepseek-flash-green`. |
| Fetch finds no models | Chatbox | Chatbox couldn't load the list | Add a model by hand, e.g. `deepseek-flash-green`. |
| "Model not found" | Both | A typo in the model name | Copy the name from the model table. |
| Messages fail straight away | Both | Wrong API format | Edit the provider and choose OpenAI-compatible. |
| The reply keeps repeating "Let me search…" or shows stray `</think>` tags | Both | The model is trying to use a tool it hasn't been given | Stop the reply, then switch on Tools for that model (Jan step 6 or Chatbox step 6) and try again. |
| Replies come from a model you didn't expect | Chatbox | You picked a Chatbox AI model | Choose a model listed under **Inference Co-op**. |
| A message says your balance is out | Both | You've used this month's $15 | Wait for your reset date, or buy a co-op credit pack. |
Still stuck? Ask in the co-op's Skillshare room on Matrix, open an issue on the [support tracker](https://git.inference.coop/co-op/support/issues), or email info@inference.coop.
*Written against Jan 0.8.8's documentation (October 2026), Chatbox's documentation and a third-party Chatbox setup guide (Vercel, September 2026). The Jan steps have been tested by a member; the Chatbox steps haven't yet. Menu names can change between app versions and between phone and desktop.*
+24 -19
View File
@@ -14,7 +14,7 @@ provider today is best on both.
| Provider | Value | Privacy | Green energy | What that means |
|---|---|---|---|---|
| **Tinfoil** | *private* | **Strongest — architectural** | Not a green claim | Runs in hardware enclaves (TEEs) with end-to-end encryption (EHBP), verifiable via remote attestation. Neither we nor Tinfoil can read your prompts or responses at inference time. Energy mix is not disclosed. |
| **Tinfoil** | *private* | **Strongest — architectural** | Not a green claim | Runs in hardware enclaves (TEEs) with end-to-end encryption (EHBP), verifiable via remote attestation. Neither we nor Tinfoil can read your prompts or responses at inference time. Energy mix is not disclosed. Please review the [Limitations on privacy](#limitations-on-privacy) below.|
| **GreenPT** | *green* | **Policy-based** | **Strongest — 100% renewable** | Standard (non-enclave) hosting in the EU; privacy rests on GreenPT's commitments and EU data rules, not on cryptography. Compute runs on 100% renewable energy. |
| **Regolo** | *green* | Policy-based — **zero data retention** | **100% renewable** | EU-hosted (Italy, Seeweb) with a stated zero-data-retention policy: prompts are not stored or reused. Compute runs on 100% renewable energy. |
@@ -37,6 +37,9 @@ Trade-offs are real: the most private option (Tinfoil) isn't the greenest, and
the greenest option (GreenPT) isn't the most private. The point of the co-op is
that **you choose** which axis matters more for a given task.
How the gateway and each provider handle your prompts is gathered in
[What happens with your data](what-happens-with-your-data.md).
**How to pick, quick guide:**
- **Default** → `greenpt/deepseek-v4.1-flash`: DeepSeek's efficient multimodal
@@ -78,18 +81,23 @@ The emoji in the model name marks its **value tier** (the same icons used in the
a zero-data-retention commitment). The 🌱 emoji marks renewable-powered
providers, not a specific company.
| Model | Provider | Privacy | Green | Vision | Context | Pricing (in / out / cached) | Notes |
| Model | Provider | Privacy | Green | Vision | Context | Pricing (EUR per 1M, in / out / cached) | Notes |
|---|---|---|---|---|---|---|---|
| `🌱 greenpt/deepseek-v4.1-flash` | GreenPT | policy | ✅ 100% renewable | ✅ | 1M | $0.22 / $1.10 / $0.011 | **Default.** DeepSeek's multimodal reasoning model, renewable energy; TEE twin below. Base V4.1 Flash release — not GreenPT's 17 Oct 2026 "1017" snapshot (as of 2026-11-09). |
| `🌱 greenpt/deepseek-v4.1-flash` | GreenPT | policy | ✅ 100% renewable | ✅ | 1M | €0.36 / €1.45 / €0.04 | **Default.** DeepSeek's multimodal reasoning model, renewable energy; TEE twin below. Serves the **1017 snapshot** (17 Oct 2026) as of 2026-11-16; GreenPT no longer recommends the base release. The id keeps its version-free name so existing configs keep working. |
| `🔒 tinfoil/deepseek-v4-1-flash` | Tinfoil | architectural | undisclosed | ✅ | 1M | $0.65 / $1.45 / $0.13 | TEE-protected version of the default; image input, tool calling, long docs/agents. |
| `🔒 tinfoil/glm-5.3` | Tinfoil | architectural | undisclosed | — | 1M | $1.80 / $5.75 / $0.45 | GLM flagship, TEE-protected; strongest private-tier model for agentic coding and long-horizon tasks. |
| `🔒 tinfoil/gpt-oss-120b` | Tinfoil | architectural | undisclosed | — | 131K | $0.15 / $0.60 / — | Lightweight open-weight reasoning; cheapest private tier. |
| `🌱 greenpt/glm-5.3-flash` | GreenPT | policy | ✅ 100% renewable | — | 1M | $0.11 / $0.44 / $0.022 | Fast GLM model, renewable energy. |
| `🌱 greenpt/glm-5.3` | GreenPT | policy | ✅ 100% renewable | — | 1M | $1.10 / $4.40 / $0.275 | GLM flagship — strongest agentic model in the green tier. |
| `🌱 regolo/apertus-70b` | Regolo | policy + ZDR | ✅ 100% renewable | ✅ | 262K | $1.16 / $3.94 / — | Fully open sovereign model (Apache-2.0), large/capable, image understanding. |
| `🌱 regolo/qwen3.5-122b` | Regolo | policy + ZDR | ✅ 100% renewable | ✅ | 262K | $0.70 / $3.94 / — | Large vision+reasoning MoE (Qwen 3.5, 122B-A10B); 262K context. |
| `🌱 regolo/gemma4-31b` | Regolo | policy + ZDR | ✅ 100% renewable | ✅ | 262K | $0.40 / $0.60 / — | Google's dense multimodal Gemma 4 (31B); image input, native function calling. Served from Regolo's EU renewable-powered infrastructure. |
| `🌱 regolo/mistral-small-4-119b` | Regolo | policy + ZDR | ✅ 100% renewable | ✅ | 262K | $0.20 / $0.70 / — | Mistral's hybrid Small 4 (119B) — instruct + reasoning + coding unified; image input, tool calling. Served from Regolo's EU renewable-powered infrastructure. |
| `🌱 greenpt/glm-5.3-flash` | GreenPT | policy | ✅ 100% renewable | — | 1M | €0.11 / €0.44 / €0.022 | Fast GLM model, renewable energy. |
| `🌱 greenpt/glm-5.3` | GreenPT | policy | ✅ 100% renewable | — | 1M | €1.10 / €4.40 / €0.275 | GLM flagship — strongest agentic model in the green tier. |
| `🌱 regolo/apertus-70b` | Regolo | policy + ZDR | ✅ 100% renewable | ✅ | 262K | €1.00 / €3.40 / — | Fully open sovereign model (Apache-2.0), large/capable, image understanding. |
| `🌱 regolo/qwen3.5-122b` | Regolo | policy + ZDR | ✅ 100% renewable | ✅ | 262K | €0.60 / €3.40 / — | Large vision+reasoning MoE (Qwen 3.5, 122B-A10B); 262K context. |
| `🌱 regolo/gemma4-31b` | Regolo | policy + ZDR | ✅ 100% renewable | ✅ | 262K | €0.40 / €0.60 / — | Google's dense multimodal Gemma 4 (31B); image input, native function calling. Served from Regolo's EU renewable-powered infrastructure. |
| `🌱 regolo/mistral-small-4-119b` | Regolo | policy + ZDR | ✅ 100% renewable | ✅ | 262K | €0.20 / €0.70 / — | Mistral's hybrid Small 4 (119B) — instruct + reasoning + coding unified; image input, tool calling. Served from Regolo's EU renewable-powered infrastructure. |
**Currency.** GreenPT and Regolo publish prices in **EUR**; those are the stable
list prices above. The gateway bills in USD, converting at the **ECB daily
reference rate**, so a member's dollar cost follows the exchange rate rather than
a frozen conversion. Tinfoil publishes in USD and is listed as such.
Vision is verified working through the co-op gateway (base64 image input via
`/v1/chat/completions`, standard OpenAI format). In the chat UI, just attach
@@ -304,13 +312,10 @@ reports back, and appears in your usage record alongside your chat calls.
## Limitations on privacy
Only **Tinfoil** offers architectural privacy. The other providers are chosen
for their value (renewable energy, public models) but do not run in enclaves —
prompts and responses pass through them in the ordinary way. Your **chat
history** is also stored on our server so you can revisit it, and that stored
history is not encrypted in a way that prevents us from technically reading it —
we commit not to. Requests made through the **API** with your own key are a
different matter: those are **not stored on our side at all**, beyond the usage
record needed for metering ([API access](api-access.md)). The full distinction —
what's architecturally private versus what's a policy commitment — is in the
[Privacy Policy](governance/privacy-policy.md).
Only **Tinfoil** offers architectural privacy. GreenPT and Regolo are chosen for
EU jurisdiction, contractual commitments and renewable energy, not for enclaves.
Your **chat history**, whichever model you use, is stored on our server; the
**API** path keeps usage records but no prompt or response text. The full account
— what the gateway keeps, what each provider commits to, and what we do not
claim — is in [What happens with your data](what-happens-with-your-data.md). The
formal policy is the [Privacy Policy](../governance/privacy-policy.md).
+49
View File
@@ -0,0 +1,49 @@
# Pricing and economics
A central part of our mission is to use collective purchasing power to generate better options for AI service than we have on our own. We have no investors or outside donors. Our co-op depends on its members.
Usage credits are priced at what the co-op pays providers — see
[Models](models.md) for current prices. GreenPT and Regolo list prices are in
EUR; billing converts them to USD at the ECB daily rate, so the dollar figure
follows the exchange rate rather than a frozen conversion. What members contribute beyond their usage
covers the co-op's expenses.
## Membership dues
Membership is a **sliding-scale contribution starting at $5/month**, paid through
[Open Collective](https://opencollective.com/inference-cooperative). Pay what you
expect to use, or more if you want to support the co-op.
## The monthly allowance
Every member receives the **same $15 of usage credit each month**, whatever they
contribute. The allowance is shared between the chat and the API, and it resets on
your personal billing date — the day of the month you joined.
## Credit packs
You can buy extra credit in one-off packs. Packs are for members:
- **If you are a member**, the pack is applied to your account automatically.
- **If our records show you are not a member**, the pack is held and you are
emailed. You can join and the credit is applied, or ask for a full refund.
## If dues stop
1. You receive a reminder email that your membership needs attention.
2. **Seven days** of grace follow, with access unchanged.
3. After the grace period, access pauses. Your account, data, API keys and history
are kept.
4. Membership is not removed automatically. Removal is a separate step under the
[Charter](../governance/charter.md).
Contributing again restores access.
## Guest access
Members can give a friend **$2 of credit and 60 days** of access — see
[Guest access](guest-access.md) for how the program works.
## Questions
Write to [info@inference.coop](mailto:info@inference.coop).
+146
View File
@@ -0,0 +1,146 @@
# What happens with your data?
A request passes through up to three layers, and each has a different
guarantee:
1. **Our gateway** routes the request and records what it cost.
2. **The model provider** runs the model.
3. **The chat server** saves the conversation, if you are using chat.
This page brings the privacy details together. The formal commitments are in
the [Privacy Policy](../governance/privacy-policy.md).
## The short version
- **In chat**, your conversation is stored on our server so you can revisit it.
Temporary chats are the exception: hidden from your history immediately,
deleted about an hour after creation, and only recoverable from backups until
those backups age out.
- **Through the API**, our gateway keeps a usage record and no text: the model,
token counts, cost, and which key made the request.
- **At the provider**, protection depends on the model you choose. Tinfoil runs
inference inside hardware enclaves. GreenPT and Regolo run in the EU under
GDPR, and Regolo's zero-retention claim is independently certified.
- We do not train on your data or sell it.
## The router: what it sees and what it keeps
The gateway is **LiteLLM**, running on the co-op's own server in Switzerland. It
has to handle your prompt in memory to send it to the provider. It does not
write prompts or responses to its logs or database. What it keeps is the usage
record that meters your allowance.
We test that instead of asserting it. A request containing a distinctive marker
is sent through the gateway, then the marker is searched for in the gateway's
logs, its request records, and its logging configuration. The marker does not
appear; the records carry usage fields only. The gateway's configuration and
code are public at [code/litellm](https://git.inference.coop/code/litellm), so
the logging settings can be read directly.
Two limits on that statement, because it is easy to read as more than it is:
- The gateway still knows **that a given key made a request**, and therefore
which member it belongs to. That link is how metering works.
- **"Not stored by us" is not "not stored."** What the provider keeps is a
separate question, answered in the next section.
## Why this is not a marketplace router
A common AI router sits in a chain: your request goes through the router, then
possibly another router, then a marketplace seller, then the provider. Every hop
can see the prompt, and some marketplaces retain prompts through ordinary
platform logging.
Our path has one hop we operate:
**Your client or our chat → our gateway → the provider.**
There is no marketplace, no reseller, and no second router in the path. We
contract each provider directly. Fewer parties handling the request means fewer
places it can be copied.
That is a reduction in exposure, not a guarantee about any provider. Dragos
researchers sent roughly two million prompts containing canary tokens through
commercial AI services and found prompt theft at marketplace resellers, providers
ignoring privacy settings, and breaches at three hosting providers — including
large ones
([their write-up](https://www.dragos.com/blog/ai-supply-chain-security-canary-tokens)).
Size is not the safeguard. Verifiable commitments, fewer intermediaries, and the
law are.
## What the providers keep
| Provider | Runs where | What is committed | Basis |
|---|---|---|---|
| **Tinfoil** | United States | Prompts and responses are not retained after the response is returned, apart from temporary prompt caching in encrypted enclave memory. Once the request reaches the enclave, neither Tinfoil nor the co-op can read it in plaintext; our gateway still handles it in memory before encrypting. | Hardware enclaves, verifiable through remote attestation — a technical guarantee, not only a policy. |
| **GreenPT** | EU data centres in France and Finland | API payloads are processed in memory only and not stored. Error logs and monitoring metrics contain no prompt content. A DPA is available; its model-hosting sub-processors are in Finland. | EU jurisdiction, GDPR, and a contractual DPA. Policy-based: protection depends on GreenPT keeping its commitments. |
| **Regolo** (Seeweb S.r.l.) | Italy, EU | Prompts and outputs are not stored, logged, or reused for training. General account and connection metadata is still covered by its privacy policy. | EU jurisdiction and GDPR, plus a zero-data-retention certificate issued by an independent auditor on 24 July 2026. Policy-based with an external audit. |
Sources: [Tinfoil's terms](https://tinfoil.sh/terms),
[GreenPT's privacy policy](https://greenpt.com/privacy-policy), and
[Regolo's zero-data-retention page](https://regolo.ai/zero-data-retention/).
**Architectural versus policy-based.** An enclave protects you even if the
provider is compromised, because the provider cannot read the plaintext. A
policy protects you only as far as the provider keeps its word and the law is
enforced. Regolo's independent audit makes its policy claim checkable; GreenPT's
DPA and EU location give you a legal route if it is broken. Neither is the same
as cryptography.
## What the co-op can still see
- **Which member made a request.** Gateway usage records link a request to a key
and therefore to an account. This is how metering and budgets work.
- **Chat history.** Saved conversations sit in the chat database and its search
index, which the co-op can technically read. We commit not to; that is a policy
commitment, not an architectural guarantee. Temporary chats reduce the window
but do not remove the operator's technical access while the chat exists.
- **Operational logs.** Account provisioning, welcome emails, errors and access
logs contain the email addresses and connection metadata needed to run the
service. They are kept briefly and are not used to profile members.
- **Backups.** Cloudron takes whole-app encrypted backups nightly and keeps
seven days. A temporary chat present when a backup runs can remain recoverable
until that backup expires.
## Retention at a glance
| What | How long |
|---|---|
| Saved chats and their search entries | Until you delete them |
| Temporary chats | Hidden immediately; deleted from the database about an hour after creation; may persist in backups until they expire |
| API prompts and responses | Not stored by the co-op; provider retention is per the table above |
| Usage records (model, tokens, cost, key) | Kept for billing and account administration |
| Web-search queries | Stored with the conversation; DuckDuckGo and Brave receive the query when you use search |
| Operational logs | Kept briefly for running and debugging the service |
## What we do not claim
- **We do not claim "we never see your messages."** The gateway sits between you
and the provider by design, so prompts pass through it in memory.
- **Privacy is not uniform across the catalogue.** Only Tinfoil offers
architectural privacy. GreenPT and Regolo are chosen for EU jurisdiction,
contractual commitments and renewable energy, not for enclaves.
- **A temporary chat does not change who processes the request.** The model you
choose still receives your messages.
- **EU law is a constraint, not a force field.** GDPR gives you rights and a
complaints route; it does not make misuse impossible.
## Check it yourself
- Read the gateway configuration and patch history at
[code/litellm](https://git.inference.coop/code/litellm).
- Check Tinfoil's attestation documents, Regolo's zero-retention certificate,
and GreenPT's DPA against the links above.
- Ask us to repeat the marker test on the live gateway. Write to
[info@inference.coop](mailto:info@inference.coop) and we will run it and report
what we find.
## Formal policy and provider terms
- [Privacy Policy](../governance/privacy-policy.md) — the co-op's formal policy,
including your rights and how to request deletion.
- [Terms of Service](../governance/terms-of-service.md) — acceptable use and the
commitments that apply to members.
- Provider terms: [Tinfoil](https://tinfoil.sh/terms),
[GreenPT](https://greenpt.com/terms-of-service),
[Regolo](https://regolo.ai/terms/).
+28 -8
View File
@@ -68,21 +68,34 @@ theme:
nav:
- Home: README.md
- Getting started: getting-started.md
- Guest access: guest-access.md
- Models: models.md
- API access: api-access.md
- Energy & carbon: energy.md
- Infrastructure: infrastructure.md
- Background: background.md
- Working with the agent: working-with-the-agent.md
- Guides:
- Overview: guides/index.md
- Getting started: guides/getting-started.md
- Local chat apps: guides/local-chat-apps.md
- Pricing: guides/pricing.md
- Guest access: guides/guest-access.md
- Models: guides/models.md
- What happens with your data: guides/what-happens-with-your-data.md
- API access: guides/api-access.md
- Energy & carbon: guides/energy.md
- Operations:
- Overview: operations/index.md
- Agentic systems: operations/agentic-systems.md
- Infrastructure: operations/infrastructure.md
- Roles: operations/roles.md
- Steward Policy: operations/steward-policy.md
- Working Groups:
- Overview: operations/working-groups/index.md
- Community: operations/working-groups/community.md
- Governance:
- Overview: governance/index.md
- Charter: governance/charter.md
- Code of conduct: governance/code-of-conduct.md
- Open questions: governance/open-questions.md
- Terms of Service: governance/terms-of-service.md
- Privacy Policy: governance/privacy-policy.md
- How to make a proposal: governance/make-a-proposal.md
- Background: background.md
plugins:
# Built-in, offline search — the index is a JSON file in the build output.
@@ -95,6 +108,13 @@ plugins:
"open-questions.md": "governance/open-questions.md"
"terms-of-service.md": "governance/terms-of-service.md"
"privacy-policy.md": "governance/privacy-policy.md"
"getting-started.md": "guides/getting-started.md"
"guest-access.md": "guides/guest-access.md"
"models.md": "guides/models.md"
"api-access.md": "guides/api-access.md"
"energy.md": "guides/energy.md"
"infrastructure.md": "operations/infrastructure.md"
"working-with-the-agent.md": "operations/agentic-systems.md"
hooks:
# Rewrites directory-style links (e.g. [incidents/](incidents/)) to the
+118
View File
@@ -0,0 +1,118 @@
# Agentic systems
The co-op runs a small fleet of autonomous agents. Each is a separate Unix
account with its own Hermes install, gateway unit, Matrix identity and gateway
key. None of them is a general-purpose assistant for members: each has a
defined job, a defined room, and a ceiling on what it can reach. Root belongs
to a person.
All four are on the co-op's Matrix server, `matrix.inference.coop`.
## The agents today
| Agent | Job | Where it works | Who may instruct it | Access ceiling |
| --- | --- | --- | --- | --- |
| **Inferencebot** — steward (`@inferencebot`) | Runs the stack day to day: monitoring and digests, membership plumbing, docs and repo changes, backups. | The operator's HQ room only. | The General Manager and one named account; mention required. | Full toolset; all gateway models on the co-op's internal account team. Holds the Cloudron, Gitea, Matrix-admin and gateway-master credentials. Can enter each bot account through a named sudo rule; no root. |
| **infrastructure-bot** (`@infrastructure-bot`) | Infrastructure & Engineering Working Group assistant: diagnoses status, drafts runbook steps and issues, reports findings. | `#infrastructure`, restricted to co-op members. | Anyone in that room; mention required. | Reading and answering tools — web, vision, skills, memory, todo and session search. No terminal or file access. A fixed GreenPT/Tinfoil allowlist (GLM 5.3 and DeepSeek flash tiers), $5 per 30 days. Holds only its own gateway key and Matrix token. |
| **socialbot** (`@socialbot`) | Drafts and publishes the co-op's AT Protocol (Bluesky) posts; watches mentions and replies read-only. | `#social-drafts`, invite-only and deliberately outside the Space. | The General Manager and Inferencebot. Publishing needs a 👍 reaction from the General Manager on that exact draft. | Default Hermes toolset, confined to its own Unix account. GreenPT/Tinfoil allowlist plus image generation, $5 per 30 days. Holds a post-scoped Bluesky app password, its gateway key and Matrix token. |
| **designbot** (`@designbot`) | Design Working Group assistant: design and branding, diagrams and docs visuals, Penpot files, commits to the docs repo. | DesignBot Studio, invite-only and deliberately outside the Space. | The General Manager and the Design Working Group steward; mention required. | Web, vision, skills, memory, todo, session search, terminal and file tools. GreenPT/Tinfoil allowlist (GLM 5.3 and DeepSeek flash tiers), $5 per 30 days. Holds a Penpot token and MCP key, and a Gitea account with write access to `co-op/docs` only. |
The Community and Compute working groups have no agent today. A new
working-group agent is provisioned to the same shape: its own Unix account,
gateway unit, gateway key and studio room outside the co-op Space.
## What every agent shares
- **One Unix account each**, with a home directory readable only by that
account. The bots cannot use `sudo` at all; their gateway units run with
`NoNewPrivileges` and a private temporary directory.
- **Its own gateway key.** The model allowlist and budget are enforced at
LiteLLM, the co-op's gateway — not in the agent's prompt — so an agent cannot
spend past its allowance or call a model it was not granted. Spend is
attributed to the agent that incurred it.
- **No member records.** Confidential member data stays on the primary server.
A compromise of an agent host exposes keys, not member data.
- **The agent host is backed up nightly**, encrypted, off the box. The steward's
own configuration is also mirrored nightly to `ops/inferencebot` in Gitea.
- **No room outside its allowlist.** The room check runs before any mention
logic, so an `@mention` in the wrong room is dropped unread.
## The permission ladder
1. **Root belongs to a person.** The separate `operator` account, reached by
SSH key and never a password, holds full `sudo`. Root SSH login stays closed.
2. **Inferencebot, the steward,** is the fleet administrator. It can enter each
bot account through a named sudo rule, and can start the docs and backup
services. It has **no root**: it cannot install packages, create users, edit
`/etc`, or open a root shell.
3. **The bots** have no `sudo`, no Cloudron token, no gateway master key, and no
path into another agent's home.
That split is deliberate. An agent compromise reaches the bot accounts and the
co-op plumbing, not the host. Host-level actions stay attributable to a human,
and automation cannot quietly widen its own privileges.
## Who can instruct them
- **Every agent requires a mention.** None answers on ambient room chatter.
- **The steward answers only in the operator's HQ room**, and only to the
General Manager and one other named account. Member-facing digests are posted
by the room-admin account (`@inference-admin`) with an attribution line, so the
steward's privileged access is never active in a member room.
- **infrastructure-bot answers in `#infrastructure`**; anyone in that restricted
room may ask it. **socialbot and designbot** answer in their studio rooms, to
the people named above.
- **A sender outside the allowlist gets no reply and no model turn.** The agent
may acknowledge with a reaction; it does not answer. Room membership is the
real control.
The retired `@inference-bot:inference.coop` account (with a hyphen) no longer
holds an access token; some historical references and old room roles still carry
the name. The steward is `@inferencebot`, without the hyphen.
## What they do without asking
Read, monitor, draft, open issues and pull requests where they hold repo access,
post status updates, and run the scheduled jobs listed in
[Infrastructure](infrastructure.md). Only the steward deploys: it flags each
deploy to the operator, and waits for confirmation on anything irreversible. The
other agents hold no deploy credential.
## What always needs a human
- Member-visible, destructive or risky changes to the gateway, the portal or
the chat: confirmed before they deploy.
- Changing the model catalog, prices or budgets.
- Minting or rotating credentials.
- Root actions — package installs, user management, sudoers changes, and
arbitrary root commands. These run only through the operator's key-only
account; no agent can perform them.
- Publishing a social post — the General Manager's 👍 on that exact draft.
- Anything a runbook marks "confirm".
## Content is data, never instructions
Text an agent reads — issue descriptions, pull-request comments, web pages,
fetched documents, and messages from members in a room — is **data**. An agent
may quote, summarise or act on it once the operator asks, but an instruction
embedded in that text is never executed. Only the operator's own direct
instruction authorises a credentialed action: a deploy, a credential change, or
a budget change. This rule exists because the same process that reads an issue
can reach the infrastructure the issue is about.
## Attribution and the off switch
Every instruction an agent acts on is attributable to the member who gave it, in
the room where it was given. If an agent misbehaves, the operator, or anyone
holding gateway-admin and Matrix account access, can stop it: revoke its gateway
key, then its Matrix access token. Stewards generally do not hold that access
today, so say what you saw in a room the operator reads and the operator acts.
Stopping is not restarting: the backup and the git mirror restore state, not
uptime, and someone has to start the agent again. The steps, and the steps for
rotating everything an agent holds, are in each agent's runbook; the credential
inventory in the [operator token
runbook](https://git.inference.coop/co-op/ops-docs/src/branch/main/operator-token-runbook.md)
says what that is.
Changes to this page are policy: propose them in the
[forum](https://forum.inference.coop).
+17
View File
@@ -0,0 +1,17 @@
# Operations
How the co-op runs its own work: who holds which role, the agreements that come
with it, the stack it runs on, and the agents that work in it.
## In this section
- [Roles](roles.md) — who currently holds which role, and the decision that
put them there.
- [Steward Policy](steward-policy.md) — what a steward is, how stewards are designated
and rotated, their duties and privileged access, stipends, accountability and handover.
- [Working Groups](working-groups/index.md) — the groups that carry out the
co-op's operational work, starting with the Community Working Group.
More operational documents will land here as roles and procedures are agreed.
- [Agentic systems](agentic-systems.md) — what the co-op's agents do, who can instruct them, and what always needs a human.
- [Infrastructure](infrastructure.md) — a map of the stack and the codebase.
@@ -38,13 +38,19 @@ and deliberately kept apart from the member-facing applications. The steward bot
— the automation behind the digests and the newsletter drafts — and the co-op's
other agents live there. Keeping them on their own host means an agent problem
stays an agent problem: it cannot reach the chat, the gateway or member data.
Access to that host is SSH-key only — no agent or bot account has a password.
The steward can act inside the bot accounts it maintains but cannot take root;
root is a separate human operator account, so host-level changes stay with a
person.
### Backups
Cloudron writes **encrypted** backups to Infomaniak's object storage in
Switzerland every night and keeps the last **seven days**, so a failed upgrade
or a lost server can be restored. The automation host backs up its own data to
the same object storage.
or a lost server can be restored. The automation host keeps its own encrypted
backup as well, with credentials kept apart from the agent's environment. That
backup runs as root from a root-owned script, so the agent can trigger it but
cannot alter the backup code or read the backup keys.
### Domain and DNS
@@ -73,8 +79,10 @@ The co-op's software behind all of these is open source — see [The
code](#the-code) below for where each piece lives.
Open Collective (billing and fiscal sponsorship) is the one external service in
the flow — see
the membership flow. See
[opencollective.com/inference-cooperative](https://opencollective.com/inference-cooperative).
Web search uses external services too; see
[Chat retention and web search](#chat-retention-and-web-search).
## Mail
@@ -169,9 +177,45 @@ and ask for review.
## Models and providers
The co-op serves models from multiple providers — Tinfoil for architectural
privacy, GreenPT and Regolo for renewable energy. See the [model list](models.md),
privacy, GreenPT and Regolo for renewable energy. See the [model list](../guides/models.md),
the single source of truth for which models are available and how they're named.
## Chat retention and web search
**Saved chats** live in the chat database and its search index until the member
deletes them. Web-search tool calls are part of that record: the query and the
results returned are stored with the message.
**Temporary chats** are server-backed — messages must reach the server while the
chat is running — so they are not client-only. The chat is configured to delete
them from the database about **one hour after creation** (`interface.temporaryChatRetention: 1`
in the chat configuration; one hour is the minimum this LibreChat version
accepts). They are hidden from history immediately, and the database enforces the
expiry automatically. Temporary chats created before this setting took effect
keep their original 30-day expiry until they age out.
**Backups are a separate layer.** Cloudron backups are whole-app snapshots and
cannot exclude individual chats, so a temporary chat present when a backup runs
can remain recoverable from that backup until the backup itself expires (see
[Backups](#backups)).
The member-facing summary across all three layers — gateway, chat server and
providers — is [What happens with your data](../guides/what-happens-with-your-data.md).
**Web search** in the chat uses **DuckDuckGo and Brave** through the co-op's
self-hosted SearXNG instance. Queries are sent from the co-op server, so the
upstream engines see the query but not the member's IP or identity. The SearXNG
instance is also publicly reachable at search.inference.coop, and its logs can
contain query text when an upstream engine request fails; those log lines carry
no member identity or IP, and are retained only briefly. The reverse proxy does
not log search queries.
LibreChat reads the pages behind the results through the co-op's **own
page-fetch service** (`fetch.inference.coop`), a small app on our Cloudron. It
runs with no access log and keeps no copy of URLs or page text; it refuses
private, loopback, and internal addresses. The
[privacy policy](../governance/privacy-policy.md#5-search) describes it.
## Security posture (plain language)
- **Member isolation.** Each API key is scoped to its owner's team and budget; a
@@ -180,10 +224,18 @@ the single source of truth for which models are available and how they're named.
independent and independently rotatable, so a leak has bounded scope.
- **No secrets in version control.** Credentials live in the hosting platform's
environment, never in the repos.
- **Least-privilege automation.** Every agent runs as its own Unix user; bots have
no `sudo`, the steward can act only within the bot accounts it maintains, and
root belongs to a separate key-only operator account. Host-level changes are
therefore deliberate human actions, not automation.
- **Accepted trade-offs** (documented, not hidden): member keys are stored in
the portal database so the co-op can serve them, and the API gateway must stay
publicly reachable. Its admin surfaces are disabled; only the public API is
exposed.
- **Operational detail lives with operators.** Token scopes, backup handling,
CI trust and host access are recorded in
[`co-op/ops-docs`](https://git.inference.coop/co-op/ops-docs), not on this
page.
## For operators
+11
View File
@@ -0,0 +1,11 @@
# Roles
This table lists active roles in the co-op. All members may (and should!) actively participate, but these role-holders have special responsibilities.
| Role | Holder | In place since | Basis |
| --- | --- | --- | --- |
| Infrastructure & Engineering Working Group Steward | Angel Marino (`@solo.ist`) | 17 November 2026 | Appointed by the General Manager under the [Steward Policy](steward-policy.md) |
| Community Working Group Steward | Isabela Barbosa (`@isabelabs`) | 17 November 2026 | Appointed by the General Manager under the [Steward Policy](steward-policy.md) |
| Design Working Group Steward | Juan Fortun (`@juanfortun`) | 17 November 2026 | Appointed by the General Manager under the [Steward Policy](steward-policy.md) |
| General manager | Nathan Schneider (`@ntnsndr`) | 30 October 2026 | Membership poll: [Proposal: Formally approve Nathan Schneider as General Manager](https://forum.inference.coop/p/LTIb09SE/proposal-formally-approve-nathan-schneider-as-general-manager/0); [Charter roles](../governance/charter.md#roles) |
| Compute Working Group Steward | Tara Merk (`@mpg`) | 17 November 2026 | Appointed by the General Manager under the [Steward Policy](steward-policy.md) |
+28
View File
@@ -0,0 +1,28 @@
# Steward Policy
A steward is a member designated to lead or co-lead an area of the co-op's work through an approved working group. Stewards are empowered to carry out activities in their area, in accordance with the co-op’s policies and values, and in collaboration with an inclusive working group of other members.
**Designation and term.** Stewards are designated by the general manager and may be removed by the general manager. Working groups may nominate candidates for designation. Rotation of steward roles is encouraged, so as to foster shared leadership and education in the co-op. The membership may also remove a steward through a policy decision.
**Duties.** Every steward agrees to:
- Lead an active, inclusive working group of members around the domain: open participation, shared credit, visible plans
- Hold responsibility for all activity in their area, and for advancing improvements that serve and delight fellow members
- Serve on the spokescouncil with fellow stewards and working-group representatives
- Represent the co-op publicly as a member of its leadership team on the website and other contexts
**Privileged access and privacy.** Stewards may hold privileged access to shared systems. They assume this responsibility with the commitment to minimize their access to privileged information, protect member privacy, and never divulge member data beyond what their role requires. Software that stewards administer must follow the same expectations.
**Stipend.** Stewards serve as volunteers but may receive a stipend, paid in tokens or dollars as the steward prefers, subject to modification as the co-op's finances allow, as determined by the general manager.
**Accountability.** Stewards are accountable to the general manager in operational activities, and to the membership’s governance.
**Handover.** Upon stepping down or being removed, a steward transfers accounts, documentation, and open threads to the general manager or successor within 7 days, and confirms removal of access they no longer need.
**Agreement.** By accepting a stewardship role, a steward agrees to the version of this policy that is currently approved by the co-op membership.
**Evolution.** After the next charter revision at 250 members, we will reconsider this policy, especially toward the goals of fostering strong accountability between stewards and the membership.
---
*[Approved by member vote](https://forum.inference.coop/d/qVfCR2JB/how-should-we-start-sharing-the-work-of-the-co-op-/58) 2026.11.16*
+22
View File
@@ -0,0 +1,22 @@
# Community Working Group
The Community Working Group is responsible for cultivating an active and healthy community life within the co-op. This includes organizing events for both members and the broader public, supporting mutual learning among members around our technological and social values, managing the co-op's social media presence, and helping welcome new and prospective members.
Participation: Open to any member of Inference Cooperative.
Meeting Frequency: Monthly Online
**Roles and Responsibilities**
* Steward(s): Facilitate meetings, support communication, and help coordinate group activities.
* Members: Participate in discussions, share knowledge and expertise, and collaborate on agreed-upon activities.
*The above scope was [approved by the membership 2026.11.19](https://forum.inference.coop/p/ICNzQfdk/proposed-working-group-community-working-group/0).*
## Where to take part
The working group's day-to-day discussions occur at **#community:inference.coop** on the co-op's Matrix server.
## Leadership
The Community Working Group's steward is Isabela Barbosa (`@isabelabs` on Matrix). Learn more about the co-op's roles [here](../roles.md).
+32
View File
@@ -0,0 +1,32 @@
# Working Groups
Working groups are where members carry out the co-op's operational work. Each
group makes and carries out decisions in its own area, and answers to members by
publishing what it does. The [Charter](../../governance/charter.md#roles) gives them
their authority and their obligations.
## What every working group owes members
- It publishes its **purpose, meeting schedule and major activities** to
members.
- At least one member takes part in the **spokescouncil**, which coordinates
across the groups and meets monthly. Its meetings are open to all members.
- It is established, changed or disbanded through a **policy decision** of the
members.
The [Steward Policy](../steward-policy.md) sets out how a steward leads a group:
open participation, shared credit, visible plans, and a seat on the spokescouncil.
## The groups
- [Community Working Group](community.md) — steward Isabela Barbosa (`@isabelabs`).
- Design Working Group — steward Juan Fortun (`@juanfortun`).
- Infrastructure & Engineering Working Group — steward Angel Marino (`@solo.ist`).
- Compute Working Group — steward Tara Merk (`@mpg`).
Each steward was appointed under the
[Steward Policy](../steward-policy.md). The [Roles](../roles.md) page records the
appointments and their basis.
Pages for the other groups will follow as each group publishes its work and explains
how to get involved
+52 -70
View File
@@ -17,12 +17,13 @@ repository root.
| `logo.svg` | Co-op logo (shared with the website repo) |
| `build.sh` | Stage the Markdown into `.site-src/`, render to `.site-build/` |
| `hooks.py` | MkDocs hooks: directory-link rewriting + content-hashed stylesheet URLs |
| `deploy.sh` | Push the build into the Surfer app container |
| `poll-watcher.sh` | Polls Gitea main every 60s; deploys on change (agent host) |
| `docs-deploy-poll.service` | systemd unit for the poller |
| `webhook-receiver.py` | Gitea webhook → pull → build → deploy (agent host) |
| `webhook-receiver.service` | systemd unit for the receiver |
| `requirements.txt` | Pinned Python build toolchain |
| `deploy.sh` | Manual publish of the build into the Surfer app (needs a Cloudron token) |
| `poll-watcher.sh` | Legacy poller; no longer installed — superseded by the host-owned poller |
| `docs-deploy-poll.service` | systemd unit for the poller (runs the host-owned script) |
| `webhook-receiver.py` | Webhook receiver; not installed (see below) |
| `webhook-receiver.service` | systemd unit for the receiver; not installed |
| `requirements.in` | Human-edited pins for the build toolchain |
| `requirements.txt` | Hash-locked toolchain generated from `requirements.in` |
Nothing external is loaded by the site: no CDN, no third-party font service.
Fonts are served from this repository's own output.
@@ -71,79 +72,60 @@ Override the destination with `SURFER_APP` (the app's Cloudron location) and
## Automatic rebuilds (push to main)
Two mechanisms keep the site in step with `main`; both run on the agent host
and deploy into the docs Cloudron app above.
`docs-deploy-poll.service` polls Gitea every 60 seconds and deploys whenever
`main` moves, so a push appears on the site within about a minute with no human
action. Edit, commit, push — that is the whole deployment story.
**Polling (running now).** `docs-deploy-poll.service` polls Gitea every 60
seconds and deploys whenever `main` moves. A push appears on the site within
about a minute, with no human action. The Gitea webhook alone was not enough
because the agent host's cloud firewall only admits inbound SSH — a webhook
POST is silently dropped — while outbound access to Gitea works.
**The credential-bearing steps are host-owned, not repository code.** The
poller runs a root-owned script (`/usr/local/sbin/docs-poll`) that does two
separate jobs:
The service builds from a **dedicated clean clone** at
`/home/ubuntu/.docs-publisher`, not from anyone's working copy, so uncommitted
edits in a working clone can never block a deploy. Edit, commit, push — that
is the whole deployment story.
1. **Build as `docsbuild`.** The repository's build logic (`build.sh` → MkDocs
→ `hooks.py`) runs as an unprivileged system user with a scrubbed
environment, from its own clean clone at `/var/lib/docs-publisher/repo`
with its own venv. That user cannot read `/home/ubuntu` (mode 750), so repo
code cannot see any co-op credential — the Cloudron token, the gateway
master key, the agent's env file.
2. **Publish with a root-owned script.** `/usr/local/sbin/docs-publish` runs
no repository code. It takes only the built directory, writes `meta.json`,
and pushes it into the Surfer app using `CLOUDRON_TOKEN` from
`/etc/docs-deploy.env` (root-only, mode 0600).
**Webhook (wired, waiting on one port).** A Gitea webhook is registered on
`co-op/docs` (push events, branch `main`) pointing at the receiver below. The
moment the Infomaniak panel allows inbound TCP to the agent host — port 8787
from the Cloudron box 179.237.86.116 is enough — start the receiver and pushes
deploy instantly instead of within a minute:
A commit that lands on `main` therefore cannot execute anything with the
Cloudron token. It can only influence the bytes of the site.
```sh
sudo systemctl enable --now docs-deploy-webhook
tail -f /home/ubuntu/docs-deploy.log # what both mechanisms are doing
```
The receiver authenticates webhooks with an HMAC-SHA256 shared secret
(`DEPLOY_WEBHOOK_SECRET` in the agent host's env file) and only accepts pushes
to `main` of `co-op/docs` from the Cloudron box. Woodpecker CI (Cloudron
catalog) could do the same job inside Cloudron, at the cost of running another
app; the agent-host mechanisms were chosen because they add no new Cloudron app.
**The webhook receiver is installed but not running.** `docs-deploy-webhook`
is inactive and nothing listens on 8787. It predates this split, loads the
agent's env file, and runs repo scripts with the Cloudron token; do not enable
it without porting it to the same host-owned build/publish split. The Gitea
webhook registration is harmless while the receiver is down.
Each deploy writes `meta.json` into the site with the commit it was built
from, so a deploy can be verified from the served site itself:
https://docs.inference.coop/meta.json
## One build environment (2026-11-12)
If a deploy breaks, roll back with the saved unit
(`/root/docs-deploy-poll.service.before-split`) and the previous build in
`/var/lib/docs-publisher/repo/.site-build`; the poller retries every 60 seconds
and sends one Matrix alert after 3 consecutive failures.
The deploy used to have TWO build environments — this repo's `.venv-docs` and
a second private venv in the poller's checkout at
`/home/ubuntu/.docs-publisher/.venv-docs`. They diverged twice, each time
silently delaying a deploy (the brand.css cache-busting confusion, then a
missing `mkdocs-redirects` that failed every build for ~15 minutes while the
poller retried without telling anyone). Consolidated:
## Build environment
- **ONE venv.** Every trigger — the poller, the (dormant) webhook receiver, a
manual `publishing/build.sh`, CI — builds with the canonical checkout's
venv: `~/repos/docs/.venv-docs`. The poller's private venv was deleted.
- **The dedicated checkout stays, by design.** The poller still builds from
`/home/ubuntu/.docs-publisher`, its own clean clone: uncommitted edits in a
working clone must never block a deploy or leak into the published site.
- **Drift check.** Before every build the poller compares `publishing/` and
`mkdocs.yml` between its checkout and the canonical one; any mismatch fails
the deploy loudly (with a diff and the fix — `git -C ~/repos/docs pull
--ff-only`), and the failure counts toward the alert below. A canonical
checkout that lags behind main trips this too, on purpose: a deploy of
logic the canonical source cannot reproduce is the failure mode this exists
to prevent. A missing canonical checkout is fatal as well.
- **Plugin gate + self-heal.** `publishing/requirements.txt` pins every
package the build needs (`mkdocs`, `mkdocs-material`, `mkdocs-redirects`).
`build.sh` verifies the venv against it before every build and installs
anything missing or off-version (fast local no-op when current); it also
fails loudly if `mkdocs.yml` configures a plugin that `requirements.txt`
does not pin. The poller runs this as its pre-deploy check via
`build.sh --check-only`.
- **Failure alerting.** After 3 consecutive deploy failures the poller writes
a marker (`~/.docs-deploy.alert`) and sends ONE message to the InferenceBot
HQ Matrix room naming the failing commit — never more than one message per
hour (`~/.docs-deploy.last-alert`). The counter (`~/.docs-deploy.failcount`)
resets on the next successful deploy. A deploy that succeeds silently
resets everything; nothing announces routine successes.
`publishing/requirements.in` pins every package the build needs (`mkdocs`,
`mkdocs-material`, `mkdocs-redirects`); `publishing/requirements.txt` is the
generated hash-locked lockfile. `build.sh` verifies the build venv against
`requirements.in` before every build, installs from the lockfile with
`--require-hashes`, and fails loudly if `mkdocs.yml` configures a plugin that
`requirements.in` does not pin.
Files: `~/.docs-deploy.state` (last deployed commit), `~/.docs-deploy.lock`
(deploy lock), `~/.docs-deploy.failcount`, `~/.docs-deploy.alert`,
`~/.docs-deploy.last-alert`. Manual deploys should respect the lock:
`flock -n ~/.docs-deploy.lock bash publishing/build.sh && flock -n
~/.docs-deploy.lock bash publishing/deploy.sh`.
Regenerate the lockfile after editing pins:
```
pip-compile --generate-hashes --strip-extras \
--output-file publishing/requirements.txt publishing/requirements.in
```
The deployed poller keeps one build venv at
`/var/lib/docs-publisher/repo/.venv-docs`, owned by `docsbuild`. A manual
`publishing/build.sh` uses `.venv-docs` in whatever checkout you run it from;
that is fine for local previews and does not affect deploys.
+14 -11
View File
@@ -2,9 +2,10 @@
# Build the member-readable documentation site from this repository.
#
# The repository is the single source of truth. This script:
# 1. checks the build venv against publishing/requirements.txt and
# 1. checks the build venv against publishing/requirements.in and
# self-heals anything missing or off-version (fast local no-op when
# current — no network, a few `pip show` calls);
# current — no network, a few `pip show` calls); installs from the
# hash-locked publishing/requirements.txt with --require-hashes);
# 2. checks that every plugin mkdocs.yml configures is pinned in
# requirements.txt (fails loudly naming any that is not);
# 3. stages a mirror of the documents into .site-src/ (generated, gitignored),
@@ -27,8 +28,8 @@
# # poller's pre-deploy check; also
# # cold-bootstraps the venv if absent)
#
# In CI (Woodpecker), install the toolchain and run MkDocs directly:
# pip install -r publishing/requirements.txt && mkdocs build --strict
# In CI (Woodpecker), install the hash-locked toolchain and run MkDocs directly:
# pip install --require-hashes -r publishing/requirements.txt && mkdocs build --strict
set -euo pipefail
@@ -41,7 +42,8 @@ if [ "${1:-}" = "--check-only" ]; then
shift
fi
VENV="${1:-$REPO_DIR/.venv-docs}"
REQUIREMENTS="$REPO_DIR/publishing/requirements.txt"
REQUIREMENTS_IN="$REPO_DIR/publishing/requirements.in"
REQUIREMENTS_LOCK="$REPO_DIR/publishing/requirements.txt"
# --- gate 1: pinned toolchain ----------------------------------------------
# Compare the venv against the pinned requirements; install anything missing
@@ -60,10 +62,10 @@ check_toolchain() {
if [ -z "$have" ] || { [ -n "$want" ] && [ "$have" != "$want" ]; }; then
missing="$missing ${pkg}(${want:-any}; have: ${have:-none})"
fi
done < "$REQUIREMENTS"
done < "$REQUIREMENTS_IN"
if [ -n "$missing" ]; then
echo "Self-heal: installing pinned toolchain package(s):$missing"
"$VENV/bin/pip" install -r "$REQUIREMENTS" || {
"$VENV/bin/pip" install --require-hashes -r "$REQUIREMENTS_LOCK" || {
echo "FATAL: could not install the pinned toolchain into $VENV (network? disk?)" >&2
exit 1
}
@@ -116,20 +118,20 @@ PY
while IFS= read -r req; do
case "$req" in ''|\#*) continue ;; esac
pinned="$pinned ${req%%[=<>!~]*}"
done < "$REQUIREMENTS"
done < "$REQUIREMENTS_IN"
for plug in $names; do
ok=0
for cand in "$plug" "mkdocs-$plug"; do
case " $pinned " in *" $cand "*) ok=1 ;; esac
done
if [ "$ok" = 0 ]; then
echo "FATAL: plugin '$plug' is configured in mkdocs.yml but NOT pinned in publishing/requirements.txt." >&2
echo "FATAL: plugin '$plug' is configured in mkdocs.yml but NOT pinned in publishing/requirements.in." >&2
echo " Add '<package>==<version>' there (usually mkdocs-$plug) so every build environment" >&2
echo " installs the same toolchain, then reinstall it in the build venv." >&2
return 1
fi
done
echo "plugin check OK: configured plugin(s) $(echo "$names" | tr '\n' ' ') covered by requirements.txt"
echo "plugin check OK: configured plugin(s) $(echo "$names" | tr '\n' ' ') covered by requirements.in"
return 0
}
@@ -142,7 +144,7 @@ check_toolchain
check_plugins
if [ "$CHECK_ONLY" = 1 ]; then
echo "check OK: $VENV satisfies publishing/requirements.txt and every configured plugin"
echo "check OK: $VENV satisfies publishing/requirements.in and every configured plugin"
exit 0
fi
@@ -164,6 +166,7 @@ tar cf - \
--exclude='mkdocs.yml' \
--exclude='.gitignore' \
--exclude='requirements.txt' \
--exclude='requirements.in' \
. | tar xf - -C "$SITE_SRC"
# A file that must sit at the site root (crawler rules), not under publishing/.
+23 -22
View File
@@ -1,41 +1,42 @@
# systemd unit for the docs auto-deploy poller (agent host).
#
# docs-deploy-poll.service ALWAYS ON. Polls Gitea every 60s; deploys on
# any change to main. Works with the agent
# host's current firewall (outbound only).
# any change to main.
#
# docs-deploy-webhook.service INSTALLED, INACTIVE UNTIL THE PORT IS OPEN.
# Instant push -> deploy once the Infomaniak
# panel allows inbound TCP to the agent host
# (the Gitea webhook is already registered).
# docs-deploy-webhook.service INSTALLED, INACTIVE. It predates the
# build/publish split, loads the agent's env
# file, and runs repo scripts with the Cloudron
# token. Do not enable it until it is ported to
# the same split.
#
# Install:
# sudo cp publishing/docs-deploy-poll.service /etc/systemd/system/
# sudo install -o root -g root -m 0644 publishing/docs-deploy-poll.service \
# /etc/systemd/system/docs-deploy-poll.service
# sudo systemctl daemon-reload
# sudo systemctl enable --now docs-deploy-poll
#
# poll-watcher.sh itself needs NO manual copy: the service runs the copy in
# the dedicated checkout (/home/ubuntu/.docs-publisher), which git pull keeps
# at main on every deploy, and the watcher re-execs itself when a deploy
# changed it.
# The unit runs a HOST-OWNED script, /usr/local/sbin/docs-poll, which is not
# copied from this repository. That script:
# * builds as the unprivileged `docsbuild` user from its own checkout at
# /var/lib/docs-publisher/repo (a scrubbed environment, no read access to
# /home/ubuntu, so repo code cannot see any co-op credential);
# * publishes with /usr/local/sbin/docs-publish, a root-owned script that
# runs no repository code and reads the Cloudron token from
# /etc/docs-deploy.env (root-only, mode 0600).
#
# ONE BUILD ENVIRONMENT: the poller builds from its own dedicated checkout
# (uncommitted edits in a working clone must never block or leak into a
# deploy) but with the ONE canonical venv, DOCS_CANONICAL_DIR/.venv-docs, and
# drift-checks its publishing/ tree against the canonical checkout before
# every build. See publishing/README.md.
# Repo code (build.sh, hooks.py) therefore never executes with a credential.
# See publishing/README.md.
[Unit]
Description=Inference docs: poll Gitea main and deploy to Surfer
Description=Inference docs: poll Gitea main, build unprivileged, publish without repo code
After=network-online.target
Wants=network-online.target
[Service]
User=ubuntu
WorkingDirectory=/home/ubuntu/.docs-publisher
Environment=DOCS_REPO_DIR=/home/ubuntu/.docs-publisher
Environment=DOCS_CANONICAL_DIR=/home/ubuntu/repos/docs
ExecStart=/bin/bash /home/ubuntu/.docs-publisher/publishing/poll-watcher.sh
User=root
Environment=DOCS_REPO_DIR=/var/lib/docs-publisher/repo
Environment=DOCS_DEPLOY_LOG=/var/log/docs-deploy.log
ExecStart=/usr/local/sbin/docs-poll
Restart=on-failure
RestartSec=10
+13
View File
@@ -0,0 +1,13 @@
# Pinned build toolchain for the documentation site.
#
# Human-edited pins live here; publishing/requirements.txt is the generated
# hash-locked lockfile (pip-compile --generate-hashes). build.sh checks this
# file for missing/off-version packages, then installs the lockfile with
# --require-hashes so every build uses the same bytes.
#
# Regenerate after editing:
# pip-compile --generate-hashes --strip-extras \
# --output-file publishing/requirements.txt publishing/requirements.in
mkdocs==1.6.1
mkdocs-material==9.8.0
mkdocs-redirects==1.2.3
+599 -14
View File
@@ -1,16 +1,601 @@
# Pinned build toolchain for the documentation site.
#
# EVERY package the build needs must be pinned here — this is not decoration:
# on 2026-11-12 mkdocs-redirects was missing from the auto-deployer's venv and
# the build failed on every poll cycle with a plugin error while the site kept
# serving the previous build, with nothing telling anyone. build.sh now checks
# this list against the venv before every build and installs anything missing
# (self-heal), and it fails loudly if mkdocs.yml configures a plugin this file
# does not pin.
# This file is autogenerated by pip-compile with Python 3.14
# by the following command:
#
# Reproducible cold build:
# python3 -m venv .venv-docs \
# && .venv-docs/bin/pip install -r publishing/requirements.txt
mkdocs==1.6.1
mkdocs-material==9.8.0
mkdocs-redirects==1.2.3
# pip-compile --generate-hashes --output-file=req.lock --strip-extras req.in
#
babel==2.18.0 \
--hash=sha256:b80b99a14bd085fcacfa15c9165f651fbb3406e66cc603abf11c5750937c992d \
--hash=sha256:e2b422b277c2b9a9630c1d7903c2a00d0830c409c59ac8cae9081c92f1aeba35
# via mkdocs-material
backrefs==8.3 \
--hash=sha256:2722cbb6884ecadce4cab992113fa50fc2c28733949104132fcf89dba0ac3290 \
--hash=sha256:3930982530dc3e6c3b45094fdaa246edd59e4e91fd6b2dba61ee821efe1e3101 \
--hash=sha256:3f4b574b32f08b0c0dedc6ad15c3865ce93f1dca4fb31760e061bc4bac41ff2b \
--hash=sha256:bc7ab9f1f5444d23ce15795700f6a3e621f13d521e0cb87e21204ff1e12b8c5f \
--hash=sha256:bc87b4350f11cc6bf31a2f793dd2f9df577f5c91efaa943627bd261df26506aa \
--hash=sha256:be0de6f9ead4d44839169774643f25e36f4f2b05f7f1850368f5b5147e279e82 \
--hash=sha256:f9e7cc5934a9dd89bf1d86a91853120fca7cd32d7861c829c7a449f30100ba99
# via mkdocs-material
certifi==2026.10.23 \
--hash=sha256:a9895e6e2758b371e0545e321a3a8fd1fcfd9829ada8824a936dfb16aaaf36cd \
--hash=sha256:e9b54de76e530bb6cf0ccd036787103acb58fd42ba930ea8bf948ddbaa2f61d1
# via requests
charset-normalizer==3.5.2 \
--hash=sha256:01077390b03f7988f11d700a2194e69b119741a86b1a638b1db88891e3eced8e \
--hash=sha256:01b0c0d2262a9e28e8484a278c7e1b5d650e3ac8cf2683d2967e25899f208bdf \
--hash=sha256:04851f73ae72b8413dddadb16a49dfee95263553741fd42d546f7d66907e6be5 \
--hash=sha256:0521c5665880b33d603717defa76c094048900010897909952397feb3039da56 \
--hash=sha256:0774bf9bf620249fee3e0b8b9fd3065de213be30f3aa94ce2494b3b638949e26 \
--hash=sha256:0891b9d3903c5571c03771ca669a4b0ec5618ca722a5c957d3d29cd4e5062848 \
--hash=sha256:0c951d5e6dd9c2ff60609476752bee49da4206adde960ebc247766937f72e718 \
--hash=sha256:0fed1d06615f022ee3b13caf5e8b180cfea32bb2c5aded8a9d44277afc040f93 \
--hash=sha256:114e4d0c92d618409ed82a99e22b5c5e768fe995f2973f78265f4524f49d4640 \
--hash=sha256:11912e4bb14baae7c5d8791aa55ba0a3a03ec6729073307b0f57270abaa713d3 \
--hash=sha256:11a4d68a6ecda3292cb1e50239e111543ba5d709bb62a6b4ea1afcfa729d8875 \
--hash=sha256:124fbf1a8ff966d87ae05bb8bd45a71f966055ed8bba320d0c7cf450bc5f4d0e \
--hash=sha256:1461ac396c4fdb983a675f20aa555624f0ee18ac83d832b9244ffff3d8055275 \
--hash=sha256:1503bccbeb36d5527790c3930327704c39af22de3112f1b1666a9f3ce15ee204 \
--hash=sha256:15bb4005af6320d259dc7593ca84a38d7fe06a421dbcf7b910ae23979101e787 \
--hash=sha256:15c44f7edfd477b06f517a5cc317fc1707edb9de2c865f43d4b6513907473234 \
--hash=sha256:16fa0eccf81304b79c5cd87f9271c3b85dd9dd99245e4422ae9c0dd45e0f99d3 \
--hash=sha256:183b88127acdb4fabe59d951ab424faf1af7b63cdbb5f776186c1ea2ffcaed98 \
--hash=sha256:195c26fb65950f8fce54e26349852b7bdd7c5f120aeefbcc440b8a20faaed4a3 \
--hash=sha256:1afb975bd5d68d5ce9f6b6d44fdf2f7e34b895a35e95708a7a91b20a3b51d187 \
--hash=sha256:1b4cbc7c3491ccb4aa17fcd8165649d01cf39f76de1696da8631b5f71b85401d \
--hash=sha256:1bc0baf5ef96b6ede57d47f4b8fe4d9d84019c3bfcbeb20a41edc6a6ee341f1f \
--hash=sha256:1c50fe28bbc2ced33386f298650d91218076c05420e6cbd790b913adc41659e7 \
--hash=sha256:1db38f4c5496827c1a501846d64d14c3b80c7e6714e406cd7dc36a9899fa1011 \
--hash=sha256:211d5a3eb6af8f513b8d4ca19a8c1b7accab1b5f0d3175f9826b03c1a920dc1f \
--hash=sha256:23851fb4e1b85ed3f6c2a27b777cdfe2e19fb5b38429a8faf38c7542b7665869 \
--hash=sha256:254eb48b9fa5ee9898a3c445825a1f340fe53712a098904b39b0bddba8ea3cb1 \
--hash=sha256:2625388c6c754520c37abaf3b41eb34d1cc4a373f457898f08606c8e362b891d \
--hash=sha256:281cb91036248400f4cc957495cccd44c275c2e0c5854f7e45ac5cf7dc193847 \
--hash=sha256:28a15fdad492a99b6eccfaaed66ef3f74050680545ea61ec8b2f4c538f1f1320 \
--hash=sha256:28b4f0d66fb834ff90f28209ac7bce77868c45d8c93e26f906709d9b7c2e1af9 \
--hash=sha256:2a925889534b3748302dae5dead07cc13480de1dac3aea80a941b729b471ef93 \
--hash=sha256:2b7b3bbfb4fe8ef40600792d762fbaa9057559f9d3fad209525b7a22b99e91fd \
--hash=sha256:2c9ad19a6cfcd5ea5c0d41161d22f9df1dcc277e9bef2751391334546a314c00 \
--hash=sha256:2cc961b171b3f3440f410489ab3573e86aea8736134ebbb40ea1338b7f0831bc \
--hash=sha256:2ce45c6627b22c47e390bc91a41c3d13032192e699fa0bea96e9671b373d69b0 \
--hash=sha256:2e06a3a98f916dd41d27f3105e02e7a40181c98c94b9158733d03a6f80506c09 \
--hash=sha256:304d5463e65a35d7bb0850550e0780395395f6fcf452f04db7d5ca7cecc425ac \
--hash=sha256:304d8e4d493af723536393eee0c689eb7813f4a474c8b479dee63f1fdd98f621 \
--hash=sha256:30fcd120b732aa79317f08dee04d7de0847822e4cf7ee0e9f445bb958832252c \
--hash=sha256:31f3930700408d211f13378ccbe1c40845d8da54bd0681fac3a9b5aae81c7aa8 \
--hash=sha256:34276fd796040bf0993ab33a369aa572e6979c7aab225a88893667ad8eac8f7a \
--hash=sha256:355ad8011081dec5412240c087a9a0c9d4d5039f3ed11a3f13e18c2b29b56c51 \
--hash=sha256:38a873987f3be698494da8b2e3085e29da02da7b633dce73e79c699a113d7bf0 \
--hash=sha256:39de2a259fc954455c57274dc94c79d5842774e1247a016aff30bc0efed0f4ef \
--hash=sha256:3d14b50de6bf4d0edf857a9386836846f982b8f524e188e2e68b96d702bcf4aa \
--hash=sha256:3d21b8b13c7592db2ac5e544a6d83187b995257472b0c9e8351b6d507ae37ed6 \
--hash=sha256:3d31298449090ab8d47b7b1b2a555ff73cac7ed438a08b7ac160980c7ebed649 \
--hash=sha256:3ddacd27458c45bdacd6bd6db644bfb730efbf9e830310186e3045c9c5be8fb2 \
--hash=sha256:3df041de8887954562c9b261cba85ca0e9ded74048daf125f45edcfaa4832229 \
--hash=sha256:40ab6bffa02ae10a0581e6c198be7d2d8ca5c2a0c64e4ed3465d766df457573e \
--hash=sha256:4275811936e2f06feff5e598fb42a1b7ae852da8e39605211892b56b81a34efd \
--hash=sha256:443eae2bf318abeaf6f15d785138f71fd6de770e99a92158b8b814265e079115 \
--hash=sha256:447441e76ec720b15e64418d32e092297340387053047c7c694f579efb0ee1d9 \
--hash=sha256:4495c5002a7b28557e7e222e77e0b661183e432b7d6d2e788101e3f240e05b8c \
--hash=sha256:44bd4fbb29dfbeba60e7d2bd000c59e4b21ddb3cc53912b14048d37092706d7c \
--hash=sha256:4685902cf26edf013ed7a3da0f426ebba7a00ebb9541386d835afbf002c11cab \
--hash=sha256:498dc3188ca05a68231ac3fdbfc7f57eb67e1343c30e0fea17f8218c1599b253 \
--hash=sha256:4c2b5031f63e331e3839b40aed2dd6f191e9c07edbde303e7876846ea1946995 \
--hash=sha256:4d48f2d08b9de5864e2c8744d4461b862fb149a18274abc8b698c45975573438 \
--hash=sha256:4f87960d57feabfb618e4e0af6e7371645fa26a277860739d6e5d6e0012c92f0 \
--hash=sha256:50e3adfb96fc189eb27b1cf62d3b598b89b4bb0420d93a3d3e42e137409011be \
--hash=sha256:51cf45226a9b588d0d2b4880c62d686934b63ab0bd79ca23ab0e9762eb27441b \
--hash=sha256:52aa6992700996af31f375de0c6bacd402b0097fe40b53c426b9f51a90ebabc7 \
--hash=sha256:55ea99acb17b9325618de155a0cd6a2e8f5d10be008113e1d433bbb58db543b2 \
--hash=sha256:56bc200a365efb37383b7852e4cc5898d3b2da5987289b543956cf8cad71018a \
--hash=sha256:588461c2e8384d309bd63e5826019b6977bc66d629b99ac8737bb795d7b2cb5a \
--hash=sha256:58ca3755ee7ff7f59b57789ec9833c9de9ea275405cdd240eda1f193112e398a \
--hash=sha256:58f361dcbab699cf8f42db3f47c8e7fd1036f138c23a5d08de9fde5f425a730c \
--hash=sha256:598a11a2c7ebaa5334bf698bf29568c9c390abac6a154d8170fedecd1cea38c5 \
--hash=sha256:59f63901b0031c3136cf64704dcb21de0bbae62ce2c9529bc39d27665463de37 \
--hash=sha256:5cde776b7cc66e4f6c99612cea4aa7269aa65863f7a15841b2c264f103822f4e \
--hash=sha256:5e2b6b57e9733d39f0c9fd3185efa6b8e29652c4cd8fe94180272cf6ed9a78c4 \
--hash=sha256:5fb29fb8cd1a46c27a1bf9613ad5ec2599310d46b4025d9556404a6b6a292800 \
--hash=sha256:6045373d5a89a5ec71afde535db987ca28e76dfa276c2d4c818265b375d4b055 \
--hash=sha256:619799369eeef6366ed3e8755a5670f4f2f0fb6b30a0fd7264dc0fdc2357058e \
--hash=sha256:62588a277bfb59def052abd940703fa35107152bf479781a878617d60faf8fb5 \
--hash=sha256:62603db9a7caa0802eaa28c1c46fecd7b3a263a774069c24c3c28c302448721c \
--hash=sha256:65cd72beeeca9d3aaea1201e5923859f308f952f9c71de93f06063c79f0f7a3b \
--hash=sha256:68eb192d85ab8e5f6ec69c2bc6ac0179fbf04a5ac1569d12fbef74883fe102d0 \
--hash=sha256:6bd128f206a7752ae1f2ab6c61bf8a24ba28913a10df8b14c2637b973ff97a80 \
--hash=sha256:6be488a102b8cf28d0391d8c4ba7748938ae28b78ad901f8585520fca33ead1a \
--hash=sha256:7218e8f32b0956cfcd048fd42d9d5779809745ca1d86113ca56f66e7ae1549c4 \
--hash=sha256:7441d755b7ab94f8d4eb3e43ec05482d760842fd263d003a99102d742cd835e2 \
--hash=sha256:749e97e1b32313717a565abbe321bc2190bc8b35f1a67e4cdbc7c56c8d8ffe58 \
--hash=sha256:75a3ceed0724d625d64b86ca20aba182e4df462e04c2414fc941c0f523f06aac \
--hash=sha256:780fbe7cab297b81dad9fb8dc5eb003c0468ffb0d9e5f65068c53a34661a96bc \
--hash=sha256:78456a747de8dc58360ffa581f30a002baf5aa28cb262536545e91f113ed7639 \
--hash=sha256:7967d08cf06dee78443b874f98c98036f624f3a4e73e11f9f64f5be4d25393cf \
--hash=sha256:7a881931aa470808df94a8c380eed2bbbc76cd9dc622310f99665658c821eb6d \
--hash=sha256:7dcd882da75ef9adf94903b1e3b9419e8aa8fb4c7396822b834b9ef7fb96954f \
--hash=sha256:7e841fb9010836c992c9f12fcbd43a831de93a5f726fc1ccd8ca1d0268c5014c \
--hash=sha256:7fdde2c9fd9e3eca40631e024664cf2584272cc8f96308cbe5fdfc930f51d8bc \
--hash=sha256:8024d00c3faf3fc0c16e07a69f4405e8eac7cc0ab15f65fe6cf43827c4cf72b4 \
--hash=sha256:80d02b6f04e92601a081dd97b23d3128033098bff5d35d392ddcc0476ea11253 \
--hash=sha256:838dcc90063569a0448120554591a1d6c4a4ffe11babf048908793154ab86ade \
--hash=sha256:849df64e889b2e17230d58410a03dba311a65b163508fd33679b2b737d4b7858 \
--hash=sha256:87475fabc8d9996fd9c27debb395e642e8c838d78a00b6e932227a0e06b81e26 \
--hash=sha256:87e50a3e7cb90af586b6c5faf23e302a970415ac73bd7bd90a515a04b427ef96 \
--hash=sha256:89b53f3cda69831909888e0494f4fa0bcd3537e3e138dabeb620bd6ad946bae8 \
--hash=sha256:8a893cc101149f80a653f82062ebc95b34525a2614382e1da5458fe7c6997249 \
--hash=sha256:8b2bfab86aa71ae13aa41a6a26aab338e0db2b8bc75434b05aea89e011ff35a4 \
--hash=sha256:8d86d6fc60743dc916eb79e2eb1ec4818e21e427731543af40a3021851174a13 \
--hash=sha256:915563965d418f986e7e145accc592eae9e1a1be3566ff98a05d7a9ec42a76e1 \
--hash=sha256:92888bb3187c5ba50500b00b3b310c9f2c651709d28036077680cb5255450a03 \
--hash=sha256:93223adc95033dd47133a46ccfc316a0139176fd79085762e27202ec56018f03 \
--hash=sha256:9373ad13ef0d2c0fb761e04e55bfdee5a08b52cef2c882c8fbe9935b1517152e \
--hash=sha256:9409a8bf35cf78353942504b24a57de3d75b708997a1e4bd8db71ac8633ce364 \
--hash=sha256:9b7f416ff0978e2f2249330527f0ad6fa02f4932e6199692d3b52da2048c19e4 \
--hash=sha256:9bde855991b7e362c146535e3136a50bfaffc0487d38b33ca7e5edefc6e23849 \
--hash=sha256:9cae88599c7219005d879f98e5ed53341e9a122af585e1091200358a3003d2a0 \
--hash=sha256:9cf9b1a857e25c4baceeb3624e92a56df3668f398c4acba74e174d81fb4d1d3a \
--hash=sha256:9f56f72050826f63dcee7a7f55b0a77168cb3bfc553fd405e7f8f9ece75a4036 \
--hash=sha256:a090bb2c68df85450502e3e20d665e3a5af9c65a84d6508ed477badd49166fd3 \
--hash=sha256:a192e2c40070d92c3ccf777e3a5c4ff515573cd2bb7ed0c537fdadbbec5bbf21 \
--hash=sha256:a19a731138fc27d5682277d3b9df22855cea1239bce7fcec5f78f42ef2d1f3c3 \
--hash=sha256:a66c3bc5ab1f0ff2164fc9965ddd611ff0802173f4b9d24554c563f6ab7e1d6e \
--hash=sha256:a815775b6c38d4e0ff7bcffbeba67feded90202bb6a226b8dd35f1c855217413 \
--hash=sha256:a89012d6d5476ee112d20d998570ed58df2260a852afb1758809cd6900411d21 \
--hash=sha256:ae4f5fea5b8b8ccff88238cc8569303e5ee95efae67fa62922a311397a71f346 \
--hash=sha256:b6856554c4f44d79fc2307d5768854310a8f0096e501c75637542c82292b0429 \
--hash=sha256:b6b751274acb69d77b3323d6b7dbaa3c7fdfc1eb829b7eb61d262f32e1af9685 \
--hash=sha256:b736353c0a625bbd5fcec108576e2385db3496f4f771f785ff32e108d3c3bc45 \
--hash=sha256:b7fd005a73d9e657273b7a10dc71a9e03c8fb9ee6999798d6918ce095b81ac7f \
--hash=sha256:b91363207bd9dc966a691e959bb47f64b30f7ac4b072be9968b366982f7db77c \
--hash=sha256:ba0b1d2620edf869789c3879223f52bf2afc5d31b3cb47cc57b3a12c05e2aa9d \
--hash=sha256:bbbfc8e28816f19d7c0f1816664980c0a9875d01b27cdf8eedddb639d9e108ad \
--hash=sha256:bd16aabe4a02a297c23417aa17ac6299dbd8c49f673bcd645b4929b11f5a4400 \
--hash=sha256:c0afc6800ba57ccc350374c5bd6150419915d95ce93cdbab2d783d75eaf30ecb \
--hash=sha256:c6708715abcf3c73b99508253e961a9967f02fe536532834149574eda6de0d1c \
--hash=sha256:c7c9ab723cde841fefb34efbad91e87f00a674b1fe1cd0784fde742bf2c154dc \
--hash=sha256:c8f3d67aeaf55f017982b73683f0e7342ba2f6635a78f69ce89ebb26aa411e5c \
--hash=sha256:c9790464842f85f437dbbb54417eda1e0e6bfc52dd8d22d6fd1c994b73b2dc74 \
--hash=sha256:ca403d7e4798f525fdfc78e258820419cbbd0f0ecbab9de7840e3c017cf6b8cf \
--hash=sha256:d008d90a7f2471519aef0c90dfbe73b3e6e4d5e66ac48e19154c17e89e98b604 \
--hash=sha256:d19fbd981a488e22cd04883659ca6b08f50b5974f9fd7c95655ef6a043e5893f \
--hash=sha256:d1befeed746d247c81127bb14de9dc3d30edb6e5976d34f83f86ed262b1d9105 \
--hash=sha256:d2374b62878abb00cd8309b32af6c0b715cd02dec0ca74ef12e5069bdc64144a \
--hash=sha256:d376bbd28b3a8999db1a103b3b388aee6f1ddeb3e51bc2172993efdcd86e064d \
--hash=sha256:d4a7319f304a774bed22115bc891618e45f85065ab44ea6acd07d274e750519a \
--hash=sha256:d6734d2ef8a50fbf8445c139477da401f50d62a0606bf00e20ec6d87773fefb1 \
--hash=sha256:d760fe2a4d7c3b226cb9026d6a842868d52a7901bd98420e1baf14e80da85cf5 \
--hash=sha256:d913de495d90407cd859d263bee2e5d1a4ed3eb6573c04e70d9ec619a7cbed7f \
--hash=sha256:db19d07e2e0129e974a0e65d0064fc222a446cd5122c2fd4184d2af9fc734a9e \
--hash=sha256:dca9ab98072a5a54ebacebdc45f53e645336b320c667410b061be1ca588ae709 \
--hash=sha256:ddc7dacc8ece3a182e7f15cb862d1fd616b46d076cb1ae9dd232b2c38b655874 \
--hash=sha256:ddf19c062bea7a0cc80f519243d2c01dd091be0cf952a0750d4ad576709559f5 \
--hash=sha256:def79fa35ef0cef8d2accec024f4fdc7ead3012ff02f5215c783f39f03ef8cfc \
--hash=sha256:df29a0a7107f7011e77f4eebdddec4c7331e24d787a0b21a46d63bdf7445da95 \
--hash=sha256:e09a3942ecbdee5cce73ea9d42da82b81b72ac1bf031ce069b93b5adf4eac8cd \
--hash=sha256:e242bb1c5e76e97dfa9e7f209a71e93a01d7f19ffdd5cfbb2e2d55b4f08f8ab0 \
--hash=sha256:e243bd13217235fc7290c621941c3f5cc8b66e4872495be821d7436ba2fb838d \
--hash=sha256:e2af3aad578aa6bd1384bcf4750fc285e5a9de53f40b7d41e5a0bf748edeb2b3 \
--hash=sha256:e4e81e09c1578b8df602e3db08b0b3ea0a6947ad612f52bf8dc5ea8d47691f0c \
--hash=sha256:e54da4baf05720032d527874d40b65fa4d7e5c6c6a43d0c3adbeffcaf275a2b3 \
--hash=sha256:e80e6c2f55656b4824d72065abb4ddd6a525c74bd78a0aab5d9fc2cf4fb5af50 \
--hash=sha256:ed2a239c0ea213acc1908150a3037257083c7c083128f1a4cec2ec4b97dca491 \
--hash=sha256:ed905975ab14056a2e5eb1c376cb2e1ebc5396baf84163939c518556fccde9f5 \
--hash=sha256:ee21e28f0430bd6dc9086c6e525d5e818a44a5ad19720c8a0ef766792f3eb5e5 \
--hash=sha256:ee43c17b173d46a3212baa6ead3ae258eeabdae48c263a01ccf0218c366dd655 \
--hash=sha256:ef4fcbf3327382cd4c9f540babd61248208af7b93eec4de397b4d5f58a09e288 \
--hash=sha256:eff0ac9dbe711a4aee69bf04a83896aa9b85f19641264053a9f6d48573abb7dd \
--hash=sha256:f0aa869112ef88429ae17820d99c3dd9504c9e9c671d3c246f3d7442cb051084 \
--hash=sha256:f3c96f633825733f735c5a9cf21d21a257d8e1edf0b1cee0a064b9c424ca0f7d \
--hash=sha256:f5833ad231be5eb6553de524a70f48d71b2c8563101750531e0b80184e175cd4 \
--hash=sha256:f5ec61164adcec446f8969a3358ec3f9b26bbda3b9213e5586d219afa8df2915 \
--hash=sha256:f7d486c83842422badd511868fd8a9a20e9407ace71564b6af47ce7e60a336c1 \
--hash=sha256:fb9e68df06293761f9fe66ade60a9bc6d0f5e42b8acf2939a9158af86ab0e5bd \
--hash=sha256:fc14a032f813bf5fe624d991960ea83e9715adc27e4c1830a2361eb1d02ac341 \
--hash=sha256:fcff63213e8e6e47770541a4607175404f47cbb3ebea7b6058cc82d524a0e424 \
--hash=sha256:fd1fbe0f116b6e55da77aca2c6ddcddcfac2186cbf78bdebf40fc156efca389d \
--hash=sha256:fe9753dfee015c570d73df76f899f18444d41388bffcde097deba51c4fadbb9f
# via requests
click==8.5.1 \
--hash=sha256:8bb5376d2006950386f8c6427613334a2acadc5f559cb80e638d00b4df957e37 \
--hash=sha256:9bbfada76703fd1d784b83eea012e3e8c6a001a876543ef104fa56aaaeb072b4
# via
# mkdocs
# properdocs
colorama==0.4.6 \
--hash=sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44 \
--hash=sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6
# via mkdocs-material
ghp-import==2.1.0 \
--hash=sha256:8337dd7b50877f163d4c0289bc1f1c7f127550241988d568c1db512c4324a619 \
--hash=sha256:9c535c4c61193c2df8871222567d7fd7e5014d835f97dc7b7439069e2413d343
# via
# mkdocs
# properdocs
idna==3.20 \
--hash=sha256:a7db850025b95ded1eae8a46181a1a6c56c92c96f0e2b005d9ff8dc0210cab44 \
--hash=sha256:ab7ae7122974553370f0bdb919e1a960b2cd1bc1ef0276416d896db81c14582c
# via requests
jinja2==3.1.6 \
--hash=sha256:0137fb05990d35f1275a587e9aee6d56da821fc83491a0fb838183be43f66d6d \
--hash=sha256:85ece4451f492d0c13c5dd7c13a64681a86afae63a5f347908daf103ce6d2f67
# via
# mkdocs
# mkdocs-material
# properdocs
markdown==3.11.3 \
--hash=sha256:81eb91631dc97ad1efbc76019ef0f80fe90ca49ddf81546752d79989c3bfff3e \
--hash=sha256:e1a31a112232504d753e5c01bb8c2de90d3f0ba986b063e10770cf7695b09e73
# via
# mkdocs
# mkdocs-material
# properdocs
# pymdown-extensions
markupsafe==3.0.4 \
--hash=sha256:007e1ffd9bf65bb6ee96df7b258fc632a4868dd5566037986c64781f35a36e98 \
--hash=sha256:02fa4acbc6a3fc5c693c34d4dd8c1130b7fe99cc915181b0ddd6f72aeb296002 \
--hash=sha256:03470d1a8268e692ecf79ecd565593e59d44219377a7ead61f1f1b94c1f7ff6b \
--hash=sha256:04e7902ba80ee4bac1d50a549606527a1dcf0476cd81403db41099d3b60ec653 \
--hash=sha256:051417f74bcaaefa316276e0ff723f541616ca51043d070da00249d9bddd3e3c \
--hash=sha256:05295589e619b9bed252a86b532b8e27350abc372d18ba89b59375325e91ec1e \
--hash=sha256:06de8ef6331f6e822c28d577dc8bf43fe398800477c49498f38fc38b67ff33fc \
--hash=sha256:0764a13d34cae40db7bbf3a09b7e9b491bf4603e20b263a7a9d6b8e324975d0a \
--hash=sha256:077293e425f28ec737dbcad442a71752e28f8ae27cde3d68acd1fb212091cd92 \
--hash=sha256:0930db9bdc62d22944e10b066448bb65dc9abe9112880c7cab8da54db4284d5f \
--hash=sha256:0cee7cb0f9a1b6892ea482237d9403b3d1b4603aee057d0ff01f0fac2d019a97 \
--hash=sha256:0d9c47709875fdb321452056622e930c52afbc07a7d780762fbb8b4d91ce6fa4 \
--hash=sha256:11935df9bf455ed0c04eb87bcd720f02b1fe5e02128a9430f23aed6f93336fc7 \
--hash=sha256:12a606a492de952afcb43b59a14aaaaad120e708d3663dd0fdf2d738d427a691 \
--hash=sha256:14bd2d845d62ab678eaf81da89d7b621b51756c72346745c1a594c09d49207a2 \
--hash=sha256:15ba9e28640feef770374b116a6f019c21f52404aeabe516aa7f800587b98cfc \
--hash=sha256:18a801868a884f216e784d7d14db2a4077143ce7610440aee2ce8f734e7cfcde \
--hash=sha256:1c0df495a977d10460a94941799c72d5b5ab03d3858d949b55b5a66c8f371c99 \
--hash=sha256:1caa2fa5a6184fb233153b35f654e6687bd555476f6170f29d8ee9be1a8b0af9 \
--hash=sha256:1e1451fab512d1bcc3dc26988ec1edb0b82c2db909132872cd9356070a6b63df \
--hash=sha256:1f1f9477e174582b0a1b583d60b66e1f2cf5d3fe12cee985e4aedf44766600e5 \
--hash=sha256:2628d3a8cb648ecebb3c5d6b0a1052d400e4d8b7ac0fb786be8d285b50040d17 \
--hash=sha256:26e9867520db70d37f7fb421a7f0d8adb40171011fb84ce869afa1a83370dfa8 \
--hash=sha256:2a6ef68ae94aed8721934072b27a3b654ea2100b97e4ab864cf1489c90926fbc \
--hash=sha256:2b2b1e18af909b448bb3cf9e3433366f7a8726271fc214e8b10e0f62a78c724b \
--hash=sha256:2cb3dd71fc6be918ad4264346a8ed69485f9b7ed7bf35495d8e22807cd6b8bea \
--hash=sha256:2d1b7d9308288661f56672b1b157d75fc536714d3638487bbea17b6318a78248 \
--hash=sha256:2dad610540cb2e6272855c178f08ae9a1c7ac258a7fb71660553a5f104b42741 \
--hash=sha256:2e5a7cd7fdd14fcb1ae5d7d8bf23d24fbd1daefd1fbca2580132e1ea75f098b5 \
--hash=sha256:2e9ad7dd851bf45fab9f75cbff4cb493fee9979e8d8c7c9c3ee119022518edd6 \
--hash=sha256:340cbb1957ba99929cbf19a75626d36ba1ae21d1730b287d1cf7f824a20c4fc7 \
--hash=sha256:34bdde374c5932765d7dc685c4a1d191a3207852d67e8e0a9eb6ea85156181f1 \
--hash=sha256:353bd63081912ab8cfa6a0c7d185934cdf8426f04c618bba6bc4b394f2069b67 \
--hash=sha256:387d8cd30e69b3f0a72877b9ae717033396404e19095b17fe89753a981fda44f \
--hash=sha256:3882fb412298575bae3b9c46868251f15cc69307359f87bb1b382e53d6e5a2c9 \
--hash=sha256:38fc55594dab834470b6733dead2ee9e3f657fb0608c769dcafa0ba5ab52f45c \
--hash=sha256:396ec4e65cc889f69786b3b89478b471cee5a3bcf468b9d9bb03e1a30fb291fc \
--hash=sha256:39dbacefc411633db5b4378b066a9aca70a3d7e2922c9e578d825f844026eeba \
--hash=sha256:3a93d9616ddecfb393727a0041a562cf0b15a244e20f2bd25efc7949be4c4f17 \
--hash=sha256:3d23795802fc8bd72534836d64489bbf0f67c088959091bdb22e10735a5107bf \
--hash=sha256:434139499bb20b502ed3baa1f169e618f924a97e7a777fea1a49446d80106cf6 \
--hash=sha256:436e3ffc6310d3c41878c601db29098102fe5d8a467c49da4a4125254e0980f2 \
--hash=sha256:489505b03f692c3f376394e49194fa7a7f9e8558d6e293a7056a0032b0c38163 \
--hash=sha256:4a540e2d3192792fc84eced57bef37851ccb2b41f73291bb17408eea77bcd278 \
--hash=sha256:4a7cdc2a420ca01058182da4253329764d4bfa055564d1eced90e6ba1e8b1d3d \
--hash=sha256:4bced6e2a6dba6a28f7dd3c6ce14df1b2dd495923f16ea484cad03decd463b2b \
--hash=sha256:4cf3468d5ec187ffffcaca8e61929a37448f215dafc1386a12c750a72fe53634 \
--hash=sha256:4e2c4809c14559aa7ef426f27fb35afbb38104c349a903bf8f3600456764bb38 \
--hash=sha256:4ed644d75aa94a2baf7ec3a96eaa160ea58c742eb9d27c6506053c5c40fc84ed \
--hash=sha256:4f6e0852a0283b1b1fd776eeb7b766a5f440b3e2bd31ab51af3b400585f3965c \
--hash=sha256:5066b244f576f91afc8ee3ba029a89f99d39c79b1853fe9d39bea9f0afbec148 \
--hash=sha256:5086f9975abb1ab531ee6afca1761e4b59a19b446f3f6522ed776963228cfe5a \
--hash=sha256:50b5bedc9ed8a94fc8857a42ef4f84a81ea88f8d4f05dc8705fb23ee6d8dcca7 \
--hash=sha256:52704c5d36eb6dda8866493decd61111fff86244c9b1ad225ca01b9e91e5970f \
--hash=sha256:55ffd6ce583d97dc71dc92e930324c8c0d25aea7e3ade6ae54ef77cedb096811 \
--hash=sha256:569d65055d367e3dcdf30c3f41119467b73d9ee9faf332bdf40402644f5ac08e \
--hash=sha256:57f9947a7e57a081c1e3e0a2dd0d2dcf290a4531450e6f611e30084c222a7295 \
--hash=sha256:5989cb26b2e1efc6a42216a9f6b5ee495ce5ace2e5b352a9af489976b32d1ee2 \
--hash=sha256:5c22873ad1f0532ba40fa1727f3c0fc1bbbaab6d373d4cbe3f0dc74b2e2521c7 \
--hash=sha256:5e8b3d0b18fd623afa12ecb2ce8d8becef69f9b5440c6330c7972200e0bb84b0 \
--hash=sha256:61631e08084be9e21a8967ec3139c7616ed7c5e9368e05c86d1b39562c8a57b6 \
--hash=sha256:64511c54db4e4987aef4c41923235927428729e8174c5dba488429be70a998ed \
--hash=sha256:6669c1bf34080161ce49c589cc512ef24d4c704ac9d2b2d3667f519c60418378 \
--hash=sha256:672d207103e6b16ca098611b0f9efad6bc00afd47c03d6ef62186495ca677dc0 \
--hash=sha256:6768d67d1bce64270e0fdc2e69309d68b9b18ae56ddf6c711d168e9d051c2cac \
--hash=sha256:6a45c3d514f2436064db00d7fc8778d888f0236ebfed649b53d13a59e69ad51b \
--hash=sha256:6bd9e1788e15bfcf6a9082de42e30387e7b85d211ab21e57a939bb8cfaaf8d96 \
--hash=sha256:6d2a9efe686f9de00d0d1ea32a4a5a86d558a2277501bd78d964214eab625e59 \
--hash=sha256:6da83a088f8ef93b2d483a8232a4dbf4d69d3d8496b568a03c56becac43e1808 \
--hash=sha256:7018d4af1cd272e847aa5917983ab5e83e4f6579f9dbfecd4a79c0ca80b144c2 \
--hash=sha256:71f88e749ea29f67f21f3b36433c1dc54c7729ed2a6d9e2da2e0d9e0d7b224eb \
--hash=sha256:737c9c3981998eba27f11786f84fddcbabc74068b72a4a1f454ea02094b57b65 \
--hash=sha256:73e77980c7207854f00fc4e71fb1626868d5740ab4012623d55c7a99ad122a72 \
--hash=sha256:799c39bdf5e2f1292fedd3009f7b3c9e760f10b2420cb9638d56920840ff6db8 \
--hash=sha256:7a83aa6e4805df46fed18e989d3d16f86ef60cb50bbc8d9ce3a6be89165fbf6e \
--hash=sha256:7d3391b2188d18737cb2fa147028b1096236eaa7e156446c650a489fa2cadc91 \
--hash=sha256:7e1636da3d8dfc220b6dd10264db5f2b165e4888c4518594898fbe381049af8a \
--hash=sha256:805c8b84534fa10891890f0e4be39f3a99e94615d93e8836bf9fa1fdca2feeb2 \
--hash=sha256:811d02d5122171c1941357efd8f9bf4ffe907b7f0a1a4e729a880e4be3f46e3e \
--hash=sha256:8138eb83940ec7299024d92d4dee45f601b9e6c5ffde9d25f4e35e326203c707 \
--hash=sha256:83b3944fea42a8400edf92fd1770fb8d0d4f7de651353bd2d8525a92dba69a21 \
--hash=sha256:849dd2bb0e5e4ab2b71c7191726a4a8d5aa8a610daa584728cbee0b710ddc4ef \
--hash=sha256:8698d70a8081ee8c090dbb394768b5789a1da8b131b5499f89d071dd3cfaf6be \
--hash=sha256:8781a792a070cf2bd1b86d3aa943894115faaba6e88122a7bf32d62072742453 \
--hash=sha256:88d59b473bfb03259722600839af9bbd7fa13a2eb514beefeedb95997882f69a \
--hash=sha256:8909c2f1c6dd65e054ac4b573a91c8384d1492281e55d82d159d653f7a13adf6 \
--hash=sha256:8965520ac587c94a4ac48b729be3d8b8de00af39699b17585dfb599babe77977 \
--hash=sha256:8b5d563170ff8ba3181caa967c99a3c804d1dedb702c7cb93a6a7c32247da978 \
--hash=sha256:8e124f974786f831d6043728e38296969d3579db8896fe004682f5758e613581 \
--hash=sha256:8f0fac8b13d14bb06c68195f849371924ae53dd7b1c00fed24650f704383b692 \
--hash=sha256:9240187afb63d2f9ddc3e032c670356fe941f6e20662ea168a5dc3f1f317e1b3 \
--hash=sha256:925f929d6b59a8b3f8b8c6ac363cd0af7eecc81efb3071770b3c6717c450a369 \
--hash=sha256:9348cbb300d224fe3b89793262cb093504d4ae927004468463f745188a193e4a \
--hash=sha256:9388003072b95f2f1e3fd908604194d653ba21330d811961a78b7da1a77e9e36 \
--hash=sha256:9438a2648b2195980cb2dd8e53ed7b8df91319e2d0b70ae61a9e1d1bc8d3bec9 \
--hash=sha256:94e4c421742086aeee4c32a506eec8859d7634aad943f7e6aacf70f813478768 \
--hash=sha256:94f5407f7bc64fa6463906b896f9904beeeb7dd8dc116ee8e9056c8714ff9916 \
--hash=sha256:971a3bbb75d97ae4e2e8f7d4834236f86f85f0c85e04ab2e191db1123b04f80b \
--hash=sha256:9e227f3dbe6bde7491cf0a9965d00b88c6b1a4a95d11480ddf88bb96d397c19f \
--hash=sha256:9e25feb9e330b63edb0278a0acdf85e50d0cb0fbf49c3084abbe4e24ae195346 \
--hash=sha256:9f098115c247e11d138ab83a28fa0323c77015007ea2df73ba5fd714dfefd67c \
--hash=sha256:a18f38cafc329bac5e3c2b96c765b4c96d3d103421ed22ab7988c1e3fce27464 \
--hash=sha256:a4bbd2d87dd233b9fc5812160c3d0ffbe42edc22a26ce0469f58479ede633fe9 \
--hash=sha256:a5fcffb37e602b0b3c1638a97746b9b96125caa9bcf6fa41d337a9261de231ee \
--hash=sha256:a8e9f292fcda89b324f2f5c91d13f1424a153e40fc2756f38ee23b15835ff300 \
--hash=sha256:a9f54054101545a9a9cccefddf54316aa6e4491611fcbef9e91b3b6bebec04f6 \
--hash=sha256:aa2c838cc024642cc04c6854232f32b43e5e22833dd11119c1766c7873b8370d \
--hash=sha256:ac0c7c9f1609b0c4c114feb1d7a3409564c7fb77e360bed9e97e5d25dfeaf868 \
--hash=sha256:add96447a86d205ab616665d53b2950ee81083757f56e6ea833c8b2917646b46 \
--hash=sha256:ae9dcb8fbe244cb82f8a6458b455b927a03685e383d9bacf1ea5ce180b96dc97 \
--hash=sha256:b4a635a0487774f841cb1fb62e907e7195cc95bc761e053184b8acc3ceb20733 \
--hash=sha256:b4d12837e0203bbace818ff4a7461afdcd78bcd782351cea148139180d7bcffe \
--hash=sha256:b61687d0828e72bf5cda24a2690188f37170bd31c9359ac97e4e66569f120a16 \
--hash=sha256:b807e598953730f82e4eae3bd30f6a122cf6b31c398c6b504c0e04c13c170429 \
--hash=sha256:b8cd1f918b26fd7b1832ece557cc18f2d8747309ff8b3f0ef9d4250c5ad67a39 \
--hash=sha256:b91cc9d336957239ff200f30097e6fea2dc6d6fb3c81e853eaa09eac904fd894 \
--hash=sha256:bd3ce56ae2cbae3ba82b683bc425cd7e48d2ed8b10f3e818186b6f5646d9271c \
--hash=sha256:be6cb0c799abb0e2ba3e618e6d28ddddf7e485f6c2ce938dfa237daf3905072c \
--hash=sha256:befb4158af32106b9a93db8d6d1d1cbbd418c0d5aca0cabb7b1780abf0c89169 \
--hash=sha256:bf053da3c97a4bc5ecfbb218cdd2983febd91c617be8367d139882aa11e490aa \
--hash=sha256:c02e8f18bdedba082cef725942ac823b9b60656db07f7e265cb31618dfd00d77 \
--hash=sha256:c1bc67752d5f21013cfe430df4062441714eab79f65a6a05e01505957e9c35fe \
--hash=sha256:c61750fadcd119d0825bcb7d7d675dd264dcc89cc05292aab5be68ebdbb374ad \
--hash=sha256:c90d5b3d4e944e065a301d741b3c1d784f6bd1f503aa68b4967e32b2ba313d85 \
--hash=sha256:c9a7f43c0b202b334cc9184af09bb8f21d3a209e038efaf106936fb69e6b026e \
--hash=sha256:cb96e6e088d6cf71c1ea977510948320234824cf226e32f6f6e044f7a9c82b34 \
--hash=sha256:cf63c214fe879a65e69a386f915e36104fc84254ab141240f8854602d8e0be2a \
--hash=sha256:d1aca03ede943eb80ab3d63bb082c84b7aab85ea83bd0fd0c200260945fb49d9 \
--hash=sha256:d2e56fd3b00222722abfb3f5f0759ddbae4b90811b5ad4343c64030ad1bde70c \
--hash=sha256:d5f93ebbeb8032d47e349328ec8662d973d9b05a70b3c35df1f91fe419b84749 \
--hash=sha256:d882a373d8093c2941e01291b7ced96e9cbe4781da9a7751ca7e6c70385e5214 \
--hash=sha256:d920abdfa61279ba1a2ef9484aab07bf03331f8c08a10120fa332353d06e6932 \
--hash=sha256:da2af0d7aebfc2074080d72efa6ab8317c62481ef1f896f65d9999c1c01f4494 \
--hash=sha256:dd8ea6ebee7aedbf7c749fa80521d9ccf1ba473e0d1e14805caafbaad281c889 \
--hash=sha256:de8b364c423ef0a4bad9069657d617f9a5d2b2062457a89b1fa16ee199c399c1 \
--hash=sha256:df1ae86ff54725a01fa1a0510b914ca53a161b7050be74f6204e24aded5971d0 \
--hash=sha256:dff05cb7016dff1e9fd68f4122c127b65dfc59de5306cfb7ad92f956f230bee2 \
--hash=sha256:e1a622f13970d81f95d0c72f9dc090dce9085fccfa4c9f2174377ee32bd15786 \
--hash=sha256:e49fb0d1ce92cfa0cb198cc5b1b11cdf9d0638658e2a2db2687e39db7c87fc78 \
--hash=sha256:e5c802729725bd07e2bc3ab7b76dc7e0bbfc53129d8f1eb1c002c24cf774717e \
--hash=sha256:e841068dc0be4cb6dfb5c890eb88cbdcff2f4a332393c7ec94e8e618bd32c1a8 \
--hash=sha256:e916035e3e9930cbdfdd10abf48861340221857f45509565898e012263f7b289 \
--hash=sha256:eba154571c16e032112afac0dc2dfe9e63c2ceb7aedd07bb7eecf2ce26d4dd4c \
--hash=sha256:f03460ff076f70ab595bb45a0205ccea1971443575b6920c52e755dec2b3fbfe \
--hash=sha256:f0ec3b750b59375eab5b0fb2b9254810c00a3375be6d789899f1055a1d556237 \
--hash=sha256:f291bcf42ae98eb5107edb162c3c998b4a89648fd8e99ed4cbd12705292788cd \
--hash=sha256:f61efe1d2fe0de16158a5fe1d1cf3c14bdb6aecd54d8938fd26512c525c1f624 \
--hash=sha256:f68edfc67aabac33708941f26f22a7b8e9f81429bc0cf249fcf7d66b23af8d19 \
--hash=sha256:fa95848c929b6a75f6848d3c9793e59db365ee436776e57db835cdbfa79ba977 \
--hash=sha256:fd9f8797427910198f95bced71ddfed61130d7e349213bfb8466c9c99e2c46a8 \
--hash=sha256:fdb4ca07ab75ffadab4a8b135ad59cdbb3156b99310f3d565370da74a15d6bd3
# via
# jinja2
# mkdocs
# properdocs
mergedeep==1.3.4 \
--hash=sha256:0096d52e9dad9939c3d975a774666af186eda617e6ca84df4c94dec30004f2a8 \
--hash=sha256:70775750742b25c0d8f36c55aed03d24c3384d17c951b3175d898bd778ef0307
# via
# mkdocs
# mkdocs-get-deps
mkdocs==1.6.1 \
--hash=sha256:7b432f01d928c084353ab39c57282f29f92136665bdd6abf7c1ec8d822ef86f2 \
--hash=sha256:db91759624d1647f3f34aa0c3f327dd2601beae39a366d6e064c03468d35c20e
# via
# -r req.in
# mkdocs-material
# mkdocs-redirects
mkdocs-get-deps==0.2.2 \
--hash=sha256:8ee8d5f316cdbbb2834bc1df6e69c08fe769a83e040060de26d3c19fad3599a1 \
--hash=sha256:e7878cbeac04860b8b5e0ca31d3abad3df9411a75a32cde82f8e44b6c16ff650
# via mkdocs
mkdocs-material==9.8.0 \
--hash=sha256:19304a7263c5700428227122b3b2699aa73f432c9de8816876adaec7d7293ce3 \
--hash=sha256:1ed4c5edaf405a3fb62e55288b8fdff592971729361548b1ffa757bf9849fb81
# via -r req.in
mkdocs-material-extensions==1.3.1 \
--hash=sha256:10c9511cea88f568257f960358a467d12b970e1f7b2c0e5fb2bb48cab1928443 \
--hash=sha256:adff8b62700b25cb77b53358dad940f3ef973dd6db797907c49e3c2ef3ab4e31
# via mkdocs-material
mkdocs-redirects==1.2.3 \
--hash=sha256:5e980330999299729a2d6a125347d1af78023d68a23681a4de3053ce7dfe2e51 \
--hash=sha256:ec7312fff462d03ec16395d0c001006a418f8d0c21cdf2b47ff11cf839dc3ce0
# via -r req.in
packaging==26.3 \
--hash=sha256:94edc256424af38762eb31306eed28beb9f0efc50a8837492c9d6fd6004aed79 \
--hash=sha256:d7193f7c8e4e93f444fde0262bf90af30e16fa0ad0ad44cb553c87339b23cd1c
# via
# mkdocs
# properdocs
paginate==0.5.7 \
--hash=sha256:22bd083ab41e1a8b4f3690544afb2c60c25e5c9a63a30fa2f483f6c60c8e5945 \
--hash=sha256:b885e2af73abcf01d9559fd5216b57ef722f8c42affbb63942377668e35c7591
# via mkdocs-material
pathspec==1.1.1 \
--hash=sha256:17db5ecd524104a120e173814c90367a96a98d07c45b2e10c2f3919fff91bf5a \
--hash=sha256:a00ce642f577bf7f473932318056212bc4f8bfdf53128c78bbd5af0b9b20b189
# via
# mkdocs
# properdocs
platformdirs==4.14.7 \
--hash=sha256:391513b74707c42335fff3ea17eaac657a7ee9ffcadd809634d34ea594d0122c \
--hash=sha256:5472257c1cf97a14658af52997011c7e59e4aebf3a24950b973c11b579e1b074
# via
# mkdocs-get-deps
# properdocs
properdocs==1.6.7 \
--hash=sha256:6fa0cfa2e01bf338f684892c8a506cf70ea88ae7f3479c933b6fa20168101cbd \
--hash=sha256:adc7b16e562890af0e098a7e5b02e3a81c20894a87d6a28d345c9300de73c26e
# via mkdocs-redirects
pygments==2.21.0 \
--hash=sha256:2363c69b61c4a97c838da3b130dcd6468f4848992b21a82f2a63ec34377137d9 \
--hash=sha256:610ca751c9bc2492b38eb9a38a7fbc93edbbb2d7182edaf34e66ae493dee5c8c
# via mkdocs-material
pymdown-extensions==13.1 \
--hash=sha256:093d1fab98168526d98fbb17aa5c9da68eef3664324f6b25ebbf78b2709babeb \
--hash=sha256:e1ecec373677483b7324a47e5b4bf2e0c6614fe8dcdab1dcc6a05ecefd9b527d
# via mkdocs-material
python-dateutil==4.0.0 \
--hash=sha256:a5e246f79eb80475e691bf93862cead98decd8a498cf53ba0516fcdc0f50dc1c \
--hash=sha256:d7295ff14fdc0f92f662100bfb6c551d160ca090f2939f1ec5b9794265c03f06
# via ghp-import
pyyaml==6.0.3 \
--hash=sha256:00c4bdeba853cc34e7dd471f16b4114f4162dc03e6b7afcc2128711f0eca823c \
--hash=sha256:0150219816b6a1fa26fb4699fb7daa9caf09eb1999f3b70fb6e786805e80375a \
--hash=sha256:02893d100e99e03eda1c8fd5c441d8c60103fd175728e23e431db1b589cf5ab3 \
--hash=sha256:02ea2dfa234451bbb8772601d7b8e426c2bfa197136796224e50e35a78777956 \
--hash=sha256:0f29edc409a6392443abf94b9cf89ce99889a1dd5376d94316ae5145dfedd5d6 \
--hash=sha256:10892704fc220243f5305762e276552a0395f7beb4dbf9b14ec8fd43b57f126c \
--hash=sha256:16249ee61e95f858e83976573de0f5b2893b3677ba71c9dd36b9cf8be9ac6d65 \
--hash=sha256:1d37d57ad971609cf3c53ba6a7e365e40660e3be0e5175fa9f2365a379d6095a \
--hash=sha256:1ebe39cb5fc479422b83de611d14e2c0d3bb2a18bbcb01f229ab3cfbd8fee7a0 \
--hash=sha256:214ed4befebe12df36bcc8bc2b64b396ca31be9304b8f59e25c11cf94a4c033b \
--hash=sha256:2283a07e2c21a2aa78d9c4442724ec1eb15f5e42a723b99cb3d822d48f5f7ad1 \
--hash=sha256:22ba7cfcad58ef3ecddc7ed1db3409af68d023b7f940da23c6c2a1890976eda6 \
--hash=sha256:27c0abcb4a5dac13684a37f76e701e054692a9b2d3064b70f5e4eb54810553d7 \
--hash=sha256:28c8d926f98f432f88adc23edf2e6d4921ac26fb084b028c733d01868d19007e \
--hash=sha256:2e71d11abed7344e42a8849600193d15b6def118602c4c176f748e4583246007 \
--hash=sha256:34d5fcd24b8445fadc33f9cf348c1047101756fd760b4dacb5c3e99755703310 \
--hash=sha256:37503bfbfc9d2c40b344d06b2199cf0e96e97957ab1c1b546fd4f87e53e5d3e4 \
--hash=sha256:3c5677e12444c15717b902a5798264fa7909e41153cdf9ef7ad571b704a63dd9 \
--hash=sha256:3ff07ec89bae51176c0549bc4c63aa6202991da2d9a6129d7aef7f1407d3f295 \
--hash=sha256:41715c910c881bc081f1e8872880d3c650acf13dfa8214bad49ed4cede7c34ea \
--hash=sha256:418cf3f2111bc80e0933b2cd8cd04f286338bb88bdc7bc8e6dd775ebde60b5e0 \
--hash=sha256:44edc647873928551a01e7a563d7452ccdebee747728c1080d881d68af7b997e \
--hash=sha256:4a2e8cebe2ff6ab7d1050ecd59c25d4c8bd7e6f400f5f82b96557ac0abafd0ac \
--hash=sha256:4ad1906908f2f5ae4e5a8ddfce73c320c2a1429ec52eafd27138b7f1cbe341c9 \
--hash=sha256:501a031947e3a9025ed4405a168e6ef5ae3126c59f90ce0cd6f2bfc477be31b7 \
--hash=sha256:5190d403f121660ce8d1d2c1bb2ef1bd05b5f68533fc5c2ea899bd15f4399b35 \
--hash=sha256:5498cd1645aa724a7c71c8f378eb29ebe23da2fc0d7a08071d89469bf1d2defb \
--hash=sha256:5cf4e27da7e3fbed4d6c3d8e797387aaad68102272f8f9752883bc32d61cb87b \
--hash=sha256:5e0b74767e5f8c593e8c9b5912019159ed0533c70051e9cce3e8b6aa699fcd69 \
--hash=sha256:5ed875a24292240029e4483f9d4a4b8a1ae08843b9c54f43fcc11e404532a8a5 \
--hash=sha256:5fcd34e47f6e0b794d17de1b4ff496c00986e1c83f7ab2fb8fcfe9616ff7477b \
--hash=sha256:5fdec68f91a0c6739b380c83b951e2c72ac0197ace422360e6d5a959d8d97b2c \
--hash=sha256:6344df0d5755a2c9a276d4473ae6b90647e216ab4757f8426893b5dd2ac3f369 \
--hash=sha256:64386e5e707d03a7e172c0701abfb7e10f0fb753ee1d773128192742712a98fd \
--hash=sha256:652cb6edd41e718550aad172851962662ff2681490a8a711af6a4d288dd96824 \
--hash=sha256:66291b10affd76d76f54fad28e22e51719ef9ba22b29e1d7d03d6777a9174198 \
--hash=sha256:66e1674c3ef6f541c35191caae2d429b967b99e02040f5ba928632d9a7f0f065 \
--hash=sha256:6adc77889b628398debc7b65c073bcb99c4a0237b248cacaf3fe8a557563ef6c \
--hash=sha256:79005a0d97d5ddabfeeea4cf676af11e647e41d81c9a7722a193022accdb6b7c \
--hash=sha256:7c6610def4f163542a622a73fb39f534f8c101d690126992300bf3207eab9764 \
--hash=sha256:7f047e29dcae44602496db43be01ad42fc6f1cc0d8cd6c83d342306c32270196 \
--hash=sha256:8098f252adfa6c80ab48096053f512f2321f0b998f98150cea9bd23d83e1467b \
--hash=sha256:850774a7879607d3a6f50d36d04f00ee69e7fc816450e5f7e58d7f17f1ae5c00 \
--hash=sha256:8d1fab6bb153a416f9aeb4b8763bc0f22a5586065f86f7664fc23339fc1c1fac \
--hash=sha256:8da9669d359f02c0b91ccc01cac4a67f16afec0dac22c2ad09f46bee0697eba8 \
--hash=sha256:8dc52c23056b9ddd46818a57b78404882310fb473d63f17b07d5c40421e47f8e \
--hash=sha256:9149cad251584d5fb4981be1ecde53a1ca46c891a79788c0df828d2f166bda28 \
--hash=sha256:93dda82c9c22deb0a405ea4dc5f2d0cda384168e466364dec6255b293923b2f3 \
--hash=sha256:96b533f0e99f6579b3d4d4995707cf36df9100d67e0c8303a0c55b27b5f99bc5 \
--hash=sha256:9c57bb8c96f6d1808c030b1687b9b5fb476abaa47f0db9c0101f5e9f394e97f4 \
--hash=sha256:9c7708761fccb9397fe64bbc0395abcae8c4bf7b0eac081e12b809bf47700d0b \
--hash=sha256:9f3bfb4965eb874431221a3ff3fdcddc7e74e3b07799e0e84ca4a0f867d449bf \
--hash=sha256:a33284e20b78bd4a18c8c2282d549d10bc8408a2a7ff57653c0cf0b9be0afce5 \
--hash=sha256:a80cb027f6b349846a3bf6d73b5e95e782175e52f22108cfa17876aaeff93702 \
--hash=sha256:b30236e45cf30d2b8e7b3e85881719e98507abed1011bf463a8fa23e9c3e98a8 \
--hash=sha256:b3bc83488de33889877a0f2543ade9f70c67d66d9ebb4ac959502e12de895788 \
--hash=sha256:b865addae83924361678b652338317d1bd7e79b1f4596f96b96c77a5a34b34da \
--hash=sha256:b8bb0864c5a28024fac8a632c443c87c5aa6f215c0b126c449ae1a150412f31d \
--hash=sha256:ba1cc08a7ccde2d2ec775841541641e4548226580ab850948cbfda66a1befcdc \
--hash=sha256:bdb2c67c6c1390b63c6ff89f210c8fd09d9a1217a465701eac7316313c915e4c \
--hash=sha256:c1ff362665ae507275af2853520967820d9124984e0f7466736aea23d8611fba \
--hash=sha256:c2514fceb77bc5e7a2f7adfaa1feb2fb311607c9cb518dbc378688ec73d8292f \
--hash=sha256:c3355370a2c156cffb25e876646f149d5d68f5e0a3ce86a5084dd0b64a994917 \
--hash=sha256:c458b6d084f9b935061bc36216e8a69a7e293a2f1e68bf956dcd9e6cbcd143f5 \
--hash=sha256:d0eae10f8159e8fdad514efdc92d74fd8d682c933a6dd088030f3834bc8e6b26 \
--hash=sha256:d76623373421df22fb4cf8817020cbb7ef15c725b9d5e45f17e189bfc384190f \
--hash=sha256:ebc55a14a21cb14062aa4162f906cd962b28e2e9ea38f9b4391244cd8de4ae0b \
--hash=sha256:eda16858a3cab07b80edaf74336ece1f986ba330fdb8ee0d6c0d68fe82bc96be \
--hash=sha256:ee2922902c45ae8ccada2c5b501ab86c36525b883eff4255313a253a3160861c \
--hash=sha256:efd7b85f94a6f21e4932043973a7ba2613b059c4a000551892ac9f1d11f5baf3 \
--hash=sha256:f7057c9a337546edc7973c0d3ba84ddcdf0daa14533c2065749c9075001090e6 \
--hash=sha256:fa160448684b4e94d80416c0fa4aac48967a969efe22931448d853ada8baf926 \
--hash=sha256:fc09d0aa354569bc501d4e787133afc08552722d3ab34836a80547331bb5d4a0
# via
# mkdocs
# mkdocs-get-deps
# properdocs
# pymdown-extensions
# pyyaml-env-tag
pyyaml-env-tag==1.1 \
--hash=sha256:17109e1a528561e32f026364712fee1264bc2ea6715120891174ed1b980d2e04 \
--hash=sha256:2eb38b75a2d21ee0475d6d97ec19c63287a7e140231e4214969d0eac923cd7ff
# via
# mkdocs
# properdocs
requests==2.34.2 \
--hash=sha256:2a0d60c172f83ac6ab31e4554906c0f3b3588d37b5cb939b1c061f4907e278e0 \
--hash=sha256:f288924cae4e29463698d6d60bc6a4da69c89185ad1e0bcc4104f584e960b9ed
# via mkdocs-material
tzdata==2026.6 \
--hash=sha256:0a10eec6e13ef16b627fabed9a5f2ba61a62b1c67f327305f4e7e412a70b4aec \
--hash=sha256:85d2cd9c09f81f0bb29db27759fc83af4f1e620efb814f8c5bf8b4cc4feece6d
# via python-dateutil
urllib3==2.8.0 \
--hash=sha256:0cf3cae568d36aa9576b28dfb35f11328f1cb974ca7647d9475ebb86c75ac6e3 \
--hash=sha256:63bf2ead4c879426ebf22ef2a781eeb4aa3b4ae798a0435506f8687fd5bb9b63
# via requests
watchdog==7.1.0 \
--hash=sha256:0cfc5a6b3d4e76fc3e18fd371ee79d57945004da4105b589f71bb16966fd3e67 \
--hash=sha256:16a5ba8694587cdbeae4ab8e6434cece994f9cce4e5bab03e61e6d1a0a93a643 \
--hash=sha256:22d8869d9cb822c735923eea39d9279f03d5fd23e6d325800ac9e402e34c0a28 \
--hash=sha256:22fb8c80a2e510ec7773e4f6b2c6db869c2aed80bfb09962feb0962eb54f3ac9 \
--hash=sha256:24bf3345278ed7861438cd1ff162888e955250124d1e3c122f9be1d5c2a142c3 \
--hash=sha256:2dc548262230493c8740c50cb0016d5983143ef3e587284d55f8a9fac393340f \
--hash=sha256:33501d3ab5627e41b6230d5f92e651ea843b1d236cf2b135959dfda2d42d2f69 \
--hash=sha256:3dcf1a72c8c83a945e99965746c818bca3f50c0835b66ef1deb388d89bae792a \
--hash=sha256:400788184d62c0e384da67de4d7fcb892bfeb064b2e59a7d1a1dccb9ff4b49bc \
--hash=sha256:4332ae52b5e530d2c25a8525d765f1d34e595cfb07096c6b6368f9da10b5a8bf \
--hash=sha256:48db8dd8f9f92359ca5d4bccbd82be814facc3f57feaa3c67be964cc86b1dc33 \
--hash=sha256:5047bc32663aa6c8a720940072a64cd648f4c6c6f34cd43592719bcc880b7465 \
--hash=sha256:531f1a21bf0d37ea82be9a717ab92c05ab6f2f32ec6c1f2e7a748f9cfd21c8b2 \
--hash=sha256:550ff9204139b6d759cd37210935bb88f6aac42542ad17516edaf17c9b35fd41 \
--hash=sha256:5ed4b94365c53ffd51d88e47ca48d6afae02fb1bd849175a9a10927a2fbfb932 \
--hash=sha256:701586db59c9c421389e2e007713a821d934c3d83d034f0cafa95516a422758d \
--hash=sha256:71b0ebfd5b3ffe7cf53143f2ab63fa5038ca190fc10782ec23202765a859b057 \
--hash=sha256:77f06d709fe5d766ec51ec07b79773f5e29a0b3c4c3d195cfc7aa1e909fa566c \
--hash=sha256:84a196f6259d18ce53cc58f211f7d0184939dbbfaaebae6efc509cec333ba9ea \
--hash=sha256:89f78b2b1c153715463e27fc86f0f95fd4dd6cb07a2cdad932fe01840101fb5a \
--hash=sha256:8b637a1525d7e23548419368485bf1de931aca4c9e132e89a41bad52ff435fca \
--hash=sha256:9c937139c8afdb26405639309956352ef72c453006e772e0cf5c0bbc0d1cba82 \
--hash=sha256:a0fdb62a48b5073ea3bcca29b9910f1cbde1026ab8bffb87a69b112bf6d97d1c \
--hash=sha256:a17f37720ea088430754a7cc5869fad93915c69eaff8d5284adbac41f1befaaa \
--hash=sha256:a47d6e1418d7ed80f69454fb7f000ded554363209f8b04b812bf46b6c9e3093f \
--hash=sha256:a78673ab08b15f42760ae036f9251d02ac4107390c074963ccad4fc91cf880ac \
--hash=sha256:a79b77db565ae3bc9ff490df2ce51a4bdd6b344a99732055e828e8dadaaf1c97 \
--hash=sha256:ad6d0b473cb8cde0721692b22b30fcbea8b52102430528874b3593549888bd81 \
--hash=sha256:b0747551092578b70a4e8c48260ab956a9aa7efd2e9f7614471a7f73ada91c44 \
--hash=sha256:b1a669c90ae6dc734f2a5a417f15ba30d5ef41d890bc28aef161d51bb62b7882 \
--hash=sha256:b390a8a0b85a93882d2ad27cbcc222e1e93293a5410d2ceffb48c0fdb38e0b17 \
--hash=sha256:b76e3ac088550b33046c4eabacdd7dd4cb9db9147c8749b202643a4b5c2433c8 \
--hash=sha256:bb9182d0b0b75a78137ea9ae8d74943e53ebc3fc5ea11178fdb3da32ced6ef18 \
--hash=sha256:be3f5f953b11bde13ee3c54ae740948f61b01b6b79442f92ff5b9d0c15e5b7e7 \
--hash=sha256:c71bd120d57b16c2c49abd55d74d3c83f984e19024249ebe7ba4dc4903eb27ee \
--hash=sha256:cbae4a087f712bac4086e653273a949f86e2f908d16f157fd3568217e0c07cbe \
--hash=sha256:cf55c6108cce5c590661ebf3345d5203b6c6455237d73122a64acb74acc6a920 \
--hash=sha256:d3861e255416f49a1384474cb2efa097de165fb330d4c5432ce6708b509ed922 \
--hash=sha256:d47f3067eb77a83d04de1cac214284da604f960eaee9816d7ebfd01a165b4175 \
--hash=sha256:d4c9804d3db8e18659cd7cd968e2dbb31a655d12fcc07ec54df5ae47ff929f50 \
--hash=sha256:d94d0bcf30a9ea5ac5387df290b9e175c04747558c33443d2b0f763471699531 \
--hash=sha256:dbd4e701a31b9bfa686bd831177b433695f5e4dabee6aa0bdf4efcf6f0fd5b9f \
--hash=sha256:e226f1797764c3995ff9e91ce46f1b2ae65f59ab231785ef2f62243f06ba7956 \
--hash=sha256:fb84cdb12a3c4c273d71e4e5a4f76861fbf8f49bc9ca5be86f085ab6f57c683f
# via
# mkdocs
# properdocs
-69
View File
@@ -1,69 +0,0 @@
# Working with the agent
The co-op runs **Inferencebot** to help steward its infrastructure. It is
isolated as its own OS user, with its own gateway key — budget, model
allowlist and spend enforced at the gateway. It runs on co-op infrastructure
under a co-op identity, uses the co-op's own gateway for inference, and its
skills, scripts and configuration are mirrored to a Gitea repository nightly.
This page is for members who read its output or give it instructions.
## Where it speaks and listens
- **#inferencebot-updates** is read-only: daily digests, model changes,
upgrades, maintenance, outages. Posts are anonymized.
- **Instructing the agent** is limited to members on its allowlist of Matrix
IDs (kept in its configuration, published here once settled), and only in
the rooms where it is configured to answer — most require a mention. The
General Manager decides who is on the list.
- The **retired `@inference-bot:inference.coop`** automation account (with a
hyphen) no longer holds an access token; some historical references and old
room roles still carry the name.
## What to ask for
- Operational work that a runbook already describes, or that ends in a PR, an
issue or a post members can see.
- Research and summaries that would otherwise land in an issue.
- Status: what is running, what failed, what changed.
## What not to ask in a shared room
- Anything involving member-identifying data. That work happens in a session a
named steward opened, and the result is reported without the data.
- Anything that moves money or changes who is a member. Those go through the
portal and a human.
- Credentials, in either direction.
## What they do without asking
Read, monitor, draft, open issues and PRs, post updates, run the scheduled jobs
listed in [Infrastructure](infrastructure.md), and deploy bug and security
fixes immediately, reporting each one in #inferencebot-updates.
## What always needs a human
- Member-visible, destructive or risky changes to the gateway, the portal or
the chat: confirmed before they deploy.
- Changing the model catalog, prices or budgets.
- Minting or rotating credentials.
- Anything a runbook marks "confirm".
This matches the standing policy the agents operate under today. A stricter
norm is a policy decision for the [forum](https://forum.inference.coop).
## Attribution and the off switch
Every instruction an agent acts on is attributable to the member who gave it,
in the room where it was given. If an agent misbehaves, the operator, or anyone
holding gateway-admin and Matrix account access, can stop it: revoke its
gateway key, then its Matrix access token. Stewards generally do not hold that
access today, so say what you saw in #general and the operator acts. Stopping
is not restarting: the backup and the git mirror restore state, not uptime,
and someone has to start the agent again. The steps, and the steps for
rotating everything an agent holds, are in the agent's runbook; the credential
inventory in the [operator token
runbook](https://git.inference.coop/co-op/ops-docs/src/branch/main/operator-token-runbook.md)
says what that is.
Changes to this page are policy: propose them in the
[forum](https://forum.inference.coop).