Author SHA1 Message Date
inference-admin 0ad009894c Updated date 2026-11-22 00:13:52 +00:00
inference-admin 03d357f1e0 Terms: permit serving others through the co-op; state the notice and grace we actually give
Two edits, both from the institutional-membership discussion (co-op/support#32).

**§4.** The prohibition on reselling or redistributing access is removed — the
bullet now prohibits sharing account credentials and nothing else — and §4 ends
with the permission stated plainly: you may provide a service of your own, so
long as your use remains subject to these Terms and you carry the acceptable-use
and privacy expectations to the people you serve. Resale stops being the thing we
prohibit; failing to carry the Terms downstream is the thing we prohibit. That
also settles the question raised in #32 of whether charging at-cost rates counts
as resale: it no longer has to.

**§8.** Termination now describes what the system does rather than what we might
wish it did: we write to you before anything changes, you get a seven-day grace
period with access continuing, and if no contribution arrives the monthly
allowance stops renewing and access pauses while the account and data stay in
place. Removal per the Charter is separate and unchanged.
2026-11-13 23:19:33 +00:00
32 changed files with 311 additions and 1607 deletions

No files matched your search

+40 -22
View File
@@ -1,25 +1,33 @@
# Woodpecker CI pipeline for co-op/docs — THIN and SECRET-FREE on purpose. # Woodpecker CI pipeline for co-op/docs — THIN on purpose.
# #
# It does NOT deploy. Publishing is host-side and split: # 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:
# #
# /usr/local/sbin/docs-poll host-owned poller (root) — pulls main # publishing/requirements.txt pinned MkDocs + Material toolchain
# publishing/build.sh runs as the unprivileged `docsbuild` user, # publishing/build.sh stage Markdown -> .site-src/, render .site-build/
# with no credentials and no access to # publishing/deploy.sh push .site-build/ into the Cloudron Surfer app
# /home/ubuntu
# /usr/local/sbin/docs-publish root-owned publish step — runs no repo code,
# holds the Cloudron token from a root-only file
# #
# CI exists only to prove the repository builds. It runs in a throwaway venv # Any change to how the site is built belongs in publishing/, never here.
# 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.
# #
# Backend note: the co-op's Woodpecker agent is a Cloudron app with no Docker # Run model: MANUAL ONLY for now. The Gitea webhook that fires this on push is
# socket, so it uses Woodpecker's `local` backend. Each step runs as a shell # deliberately NOT wired — the poll watcher (docs-deploy-poll.service on the
# command INSIDE the agent container; the `image:` field selects the SHELL, not # agent host) remains the live auto-deploy path until a manual run has proven
# a container image. That is exactly why this file must stay secret-free: the # the pipeline. Once it has, add `push` to the `when` block below and register
# container is shared by every pipeline. # 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.
when: when:
- event: manual - event: manual
@@ -28,7 +36,17 @@ steps:
- name: build - name: build
image: bash image: bash
commands: commands:
# Ephemeral toolchain per run — no shared venv, no /opt/docs-venv. # Reuses the toolchain pre-installed in the agent image; build.sh only
- python3 -m venv .ci-venv # creates/installs a venv if the one given is missing, which it is not.
- .ci-venv/bin/pip install -q --require-hashes -r publishing/requirements.txt - publishing/build.sh /opt/docs-venv
- publishing/build.sh .ci-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
-8
View File
@@ -1,8 +0,0 @@
# 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
+6 -7
View File
@@ -10,14 +10,13 @@ funded through our [Open Collective](https://opencollective.com/inference-cooper
## Start here ## Start here
- **New here?** → [Getting started](guides/getting-started.md) — join, use the chat, and get involved in governance. - **New here?** → [Getting started](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. - **Why does this exist?** → [Background](background.md) — a one-page summary of the mission and history.
- **Which models can I use?** → [Models](guides/models.md) — the full catalog of providers and models. - **Which models can I use?** → [Models](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](api-access.md) — use our models programmatically.
- **Want API access?** → [API access](guides/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.
- **What does it cost?** → [Pricing](guides/pricing.md) — dues, the monthly allowance, credit packs and what happens if dues stop. - **Curious how it works?** → [Infrastructure](infrastructure.md) — a map of the stack and the codebase.
- **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. - **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.
- **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. - **Need help or have an idea?** → [Support & feature requests](https://git.inference.coop/co-op/support) — open an issue.
## Key links ## Key links
+6 -31
View File
@@ -34,9 +34,7 @@ Two things worth being precise about:
[model list](models.md) distinguishes policy-based zero retention from [model list](models.md) distinguishes policy-based zero retention from
enclave-based protection. enclave-based protection.
Full detail, including what we can and cannot see: Full detail, including what we can and cannot see: [privacy policy](governance/privacy-policy.md).
[What happens with your data](what-happens-with-your-data.md) and the
[privacy policy](../governance/privacy-policy.md).
## Get a key ## Get a key
@@ -100,8 +98,7 @@ endpoint configuration:
- **API type / protocol:** "OpenAI compatible" (or `openai-completions` where a - **API type / protocol:** "OpenAI compatible" (or `openai-completions` where a
protocol string must be named) — not "Ollama", "Anthropic", or "Responses" protocol string must be named) — not "Ollama", "Anthropic", or "Responses"
- **API key:** your member key (the `sk-…` string) - **API key:** your member key (the `sk-…` string)
- **Model:** a **stable alias** — `deepseek-flash-green`, `glm-flash-green`, `deepseek-flash-tee`, or `glm-tee` - **Model:** one from the [model list](models.md), e.g. `tinfoil/deepseek-v4-1-flash` or `greenpt/glm-5.3-flash`
— or any id from the [model list](models.md), e.g. `tinfoil/deepseek-v4-1-flash`
A typical provider entry looks like: A typical provider entry looks like:
@@ -113,38 +110,16 @@ A typical provider entry looks like:
"api": "openai-completions", "api": "openai-completions",
"apiKey": "sk-your-key", "apiKey": "sk-your-key",
"models": [ "models": [
{ "id": "deepseek-flash-green" }, { "id": "tinfoil/deepseek-v4-1-flash" },
{ "id": "glm-flash-green" }, { "id": "tinfoil/gpt-oss-120b" },
{ "id": "deepseek-flash-tee" }, { "id": "tinfoil/glm-5.3" },
{ "id": "glm-tee" } { "id": "greenpt/glm-5.3-flash" }
] ]
} }
} }
} }
``` ```
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. If a tool's own docs show a local-server example (e.g.
`baseUrl: http://localhost:11434/v1` with `api: "openai-completions"`), `baseUrl: http://localhost:11434/v1` with `api: "openai-completions"`),
substitute our base URL and your member key for `apiKey` — the protocol value substitute our base URL and your member key for `apiKey` — the protocol value
+1 -1
View File
@@ -9,7 +9,7 @@ together.
We are a small cooperative by design, fiscally sponsored by the nonprofit We are a small cooperative by design, fiscally sponsored by the nonprofit
[Metagov](https://metagov.org) and managing member dues on [Metagov](https://metagov.org) and managing member dues on
[Open Collective](https://opencollective.com/inference-cooperative). [Open Collective](https://opencollective.com/inference-cooperative).
For how to join and use it, see [Getting started](guides/getting-started.md); For how to join and use it, see [Getting started](getting-started.md);
for our governance model, see the [Charter](governance/charter.md). for our governance model, see the [Charter](governance/charter.md).
## How we got here ## How we got here
View File
File renamed without changes.
@@ -14,7 +14,8 @@ where we share dates and details. Check it for what's coming up.
## 1. Become a member ## 1. Become a member
Membership is a **sliding-scale contribution starting at $5/month** through Membership is a **sliding-scale contribution starting at $5/month** through
Open Collective (pay what fits your circumstances). Open Collective (the suggested level is $15 — pay what fits your
circumstances).
1. Go to [opencollective.com/inference-cooperative](https://opencollective.com/inference-cooperative). 1. Go to [opencollective.com/inference-cooperative](https://opencollective.com/inference-cooperative).
2. Choose a contribution amount ($5 minimum) and subscribe. 2. Choose a contribution amount ($5 minimum) and subscribe.
@@ -56,10 +57,8 @@ with the account you created in step 1.
(GreenPT and Regolo, 100% renewable energy — Regolo adds a written (GreenPT and Regolo, 100% renewable energy — Regolo adds a written
zero-data-retention policy). See the [model list](models.md) for the full zero-data-retention policy). See the [model list](models.md) for the full
list. list.
- **Web search.** Click the **globe** next to the message box to base answers - **Web search** — click the **globe** next to the message box to ground
on current web results. Searches use our self-hosted SearXNG instance, and answers in current web results (self-hosted search, no external dependency).
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 - **File uploads** — attach a document with the **paperclip** and ask the
chat about it. chat about it.
- **Tools** — the **Tools menu** next to the message box lists everything the - **Tools** — the **Tools menu** next to the message box lists everything the
@@ -67,14 +66,13 @@ with the account you created in step 1.
there's a tool you'd like available, ask in #general. there's a tool you'd like available, ask in #general.
- **Voice** works in both directions: speak to the chat with the microphone - **Voice** works in both directions: speak to the chat with the microphone
icon, and have replies read aloud. icon, and have replies read aloud.
- **Temporary chats** — for conversations you don't want in your history. Click - **Temporary chats** — for conversations you don't want kept on our servers
the **Temporary Chat** toggle (in the chat header): the conversation is hidden at all. Click the **Temporary Chat** toggle (in the chat header) and the
from your history immediately and deleted from our database about an hour conversation is never saved: it disappears when you leave the page, and
after creation. It still reaches our server while the chat runs, and it can nothing lands in your history or our database. To make this your default,
remain in backups until they age out. To make this your default, open open **Settings → Conversations** and turn on **Default Temporary Chat**.
**Settings → Conversations** and turn on **Default Temporary Chat**. For For anything sensitive, we recommend a temporary chat — ideally paired with
anything sensitive, pair a temporary chat with a 🔒 enclave model. See a 🔒 enclave model. See [Privacy](governance/privacy-policy.md#4-what-we-can-see-an-honest-caveat)).
[What happens with your data](what-happens-with-your-data.md).
Your usage draws from your monthly allowance; you can see it on the Your usage draws from your monthly allowance; you can see it on the
[Member Dashboard](https://dashboard.inference.coop). [Member Dashboard](https://dashboard.inference.coop).
@@ -87,22 +85,6 @@ see "Your allowance" below.
> — your full history is here in the new chat, but files you attached in the > — your full history is here in the new chat, but files you attached in the
> old one are still accessible only there. > 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 ### Add the chat to your phone
The chat works like an app on your phone — no app store needed. Open The chat works like an app on your phone — no app store needed. Open
@@ -174,17 +156,17 @@ privacy, and direction happen on our **Loomio forum**:
the co-op grows. the co-op grows.
- The updates feed is posted by the co-op's automation account. See - The updates feed is posted by the co-op's automation account. See
[Working with the agent](../operations/agentic-systems.md) for the agents behind [Working with the agent](working-with-the-agent.md) for the agents behind
it, what they do, and how members interact with them. it, what they do, and how members interact with them.
- See the [Charter](../governance/charter.md) for how governance is structured. - 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 [Open questions](governance/open-questions.md) for the decisions currently on the table.
### Help build it ### Help build it
Everything we run is open source, and members are welcome to contribute code, Everything we run is open source, and members are welcome to contribute code,
documentation, and design. See [Infrastructure](../operations/infrastructure.md) for the map documentation, and design. See [Infrastructure](infrastructure.md) for the map
and the "Contributing" section for how to propose changes through and the "Contributing" section for how to propose changes through
[git.inference.coop](https://git.inference.coop). [git.inference.coop](https://git.inference.coop).
+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: This charter is the core governing document. Members are also bound by the following agreements:
* [Code of Conduct](code-of-conduct.md) * [Code of Conduct](../code-of-conduct.md)
* [Terms of Service](terms-of-service.md) * [Terms of Service](../terms-of-service.md)
* [Privacy Policy](privacy-policy.md) * [Privacy Policy](../privacy-policy.md)
## Legal entity ## Legal entity
-14
View File
@@ -1,14 +0,0 @@
# 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? ### How should pricing account for unequal usage?
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. 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.
- **Flat (current):** simple, predictable, but heavy users subsidize light users (or vice versa). - **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. - **Usage-based:** pay for what you use, but unpredictable and may discourage experimentation.
+8 -31
View File
@@ -12,9 +12,6 @@
The full policy is below. Questions? info@inference.coop. 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 ## 1. Our privacy philosophy
@@ -46,7 +43,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. 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 deleted shortly 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 never stored afterwards.
### If you use the API, nothing you send is stored ### If you use the API, nothing you send is stored
@@ -74,7 +71,7 @@ it is:
The chat has a **Temporary Chat** mode designed exactly for this: The chat has a **Temporary Chat** mode designed exactly for this:
- 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). - 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.
- 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. - 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. - 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.
@@ -86,31 +83,13 @@ Our server software keeps standard operational logs (dates, error messages, and
## 5. Search ## 5. Search
Our self-hosted **SearXNG** instance at 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.
[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 ## 6. What we do NOT do
- We do **not** train models on your data. - We do **not** train models on your data.
- We do **not** sell or rent your data. - We do **not** sell, rent, or share your data.
- We do **not** share data for advertising or profiling. The service providers - We do **not** use your data for advertising or profiling.
in §5 and §7 process data to run the service.
## 7. Third parties ## 7. Third parties
@@ -118,13 +97,12 @@ 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). - **Open Collective** — handles billing and membership (their own privacy policy applies).
- **Cloudron** — our self-hosted platform; no third-party cloud provider. - **Cloudron** — our self-hosted platform; no third-party cloud provider.
- **Search engines.** DuckDuckGo and Brave receive your search queries (see §5). - **Search engines** — receive your search queries (see §5).
Page fetching runs on co-op infrastructure, not at a third party.
## 8. Retention and deletion ## 8. Retention and deletion
- Chat history is retained until you delete it. - Chat history is retained until you delete it.
- **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). - **Temporary chats are never retained** — they are not written to our database at all (see §4).
- On leaving, your account is deactivated (data preserved for reactivation). - On leaving, your account is deactivated (data preserved for reactivation).
- You may request full deletion at any time: info@inference.coop. - You may request full deletion at any time: info@inference.coop.
@@ -132,8 +110,7 @@ The models we serve are provided by third parties that change over time, each wi
- Self-hosted on Cloudron (sandboxed apps, SSL, backups). - Self-hosted on Cloudron (sandboxed apps, SSL, backups).
- Per-member API keys; access gated on live membership. - Per-member API keys; access gated on live membership.
- Core infrastructure has no external dependencies. Web search sends queries - No external dependencies for core infrastructure.
to the search engines named in §5; page fetching runs on co-op infrastructure.
## 10. Your rights ## 10. Your rights
+9 -6
View File
@@ -1,6 +1,6 @@
# Terms of Service # Terms of Service
**Last updated:** October 6, 2026 **Last updated:** November 21, 2026
## In plain language ## In plain language
@@ -38,7 +38,7 @@ We provide:
- **Web search** and **file uploads** within the chat interface. - **Web search** and **file uploads** within the chat interface.
- **Governance** — a seat in decisions about models, pricing, and direction. - **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. 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,10 +55,12 @@ 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 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). - 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. - Attempt to circumvent usage limits, the privacy architecture, or rate limits.
- Share your account credentials, or resell or redistribute access to the service. - Share your account credentials.
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 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 ## 5. Usage limits
- Membership includes a **monthly credit budget** (currently $15 of usage, the same for every member regardless of what you pay). - Membership includes a **monthly credit budget** (currently $15 of usage, the same for every member regardless of what you pay).
@@ -73,17 +75,18 @@ You are **responsible for what you submit and what you do with AI outputs**, and
- Your prompts and the AI's outputs are yours to keep. - Your prompts and the AI's outputs are yours to keep.
- We do **not** train models on your data. - We do **not** train models on your data.
- We do **not** sell or share your content. - 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 ## 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 ## 8. Termination
- You may leave at any time by cancelling on Open Collective. - 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. - On leaving, your account is deactivated (data preserved for reactivation). You may request full deletion.
- We may remove members per the Charter (Code of Conduct, non-payment). - **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).
## 9. Governance ## 9. Governance
+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 [dashboard.inference.coop](https://dashboard.inference.coop) showing what's
left. left.
- **The weekly newsletter** and these public docs. - **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. Guest access is not membership — no Matrix, governance forum, or vote.
## When it ends ## When it ends
When **the $2 is spent or the 60 days are up**, whichever comes first, your When **the $2 is spent or the 60 days are up**, whichever comes first, your
friend gets an email saying so, and access stops. A guest can end it early with the **Cancel guest access** link 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
on their dashboard, returning any unspent credit to the co-op. on their dashboard, returning any unspent credit to the co-op.
## Becoming a member ## Becoming a member
Guests can join the co-op on Contribute 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 [Open Collective](https://opencollective.com/inference-cooperative/contribute)
and the account converts automatically — same login, same dashboard. Any
unspent guest credit carries over. See unspent guest credit carries over. See
[Become a member](getting-started.md#1-become-a-member) for how membership [Become a member](getting-started.md#1-become-a-member) for how membership
works. works.
-13
View File
@@ -1,13 +0,0 @@
# 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
@@ -1,200 +0,0 @@
# 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.*
-49
View File
@@ -1,49 +0,0 @@
# 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
@@ -1,146 +0,0 @@
# 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/).
@@ -38,19 +38,13 @@ 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 — 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 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. 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 ### Backups
Cloudron writes **encrypted** backups to Infomaniak's object storage in Cloudron writes **encrypted** backups to Infomaniak's object storage in
Switzerland every night and keeps the last **seven days**, so a failed upgrade Switzerland every night and keeps the last **seven days**, so a failed upgrade
or a lost server can be restored. The automation host keeps its own encrypted or a lost server can be restored. The automation host backs up its own data to
backup as well, with credentials kept apart from the agent's environment. That the same object storage.
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 ### Domain and DNS
@@ -79,10 +73,8 @@ The co-op's software behind all of these is open source — see [The
code](#the-code) below for where each piece lives. code](#the-code) below for where each piece lives.
Open Collective (billing and fiscal sponsorship) is the one external service in Open Collective (billing and fiscal sponsorship) is the one external service in
the membership flow. See the flow — see
[opencollective.com/inference-cooperative](https://opencollective.com/inference-cooperative). [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 ## Mail
@@ -177,45 +169,9 @@ and ask for review.
## Models and providers ## Models and providers
The co-op serves models from multiple providers — Tinfoil for architectural The co-op serves models from multiple providers — Tinfoil for architectural
privacy, GreenPT and Regolo for renewable energy. See the [model list](../guides/models.md), privacy, GreenPT and Regolo for renewable energy. See the [model list](models.md),
the single source of truth for which models are available and how they're named. 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) ## Security posture (plain language)
- **Member isolation.** Each API key is scoped to its owner's team and budget; a - **Member isolation.** Each API key is scoped to its owner's team and budget; a
@@ -224,18 +180,10 @@ private, loopback, and internal addresses. The
independent and independently rotatable, so a leak has bounded scope. independent and independently rotatable, so a leak has bounded scope.
- **No secrets in version control.** Credentials live in the hosting platform's - **No secrets in version control.** Credentials live in the hosting platform's
environment, never in the repos. 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 - **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 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 publicly reachable. Its admin surfaces are disabled; only the public API is
exposed. 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 ## For operators
+8 -28
View File
@@ -68,34 +68,21 @@ theme:
nav: nav:
- Home: README.md - Home: README.md
- Guides: - Getting started: getting-started.md
- Overview: guides/index.md - Guest access: guest-access.md
- Getting started: guides/getting-started.md - Models: models.md
- Local chat apps: guides/local-chat-apps.md - API access: api-access.md
- Pricing: guides/pricing.md - Energy & carbon: energy.md
- Guest access: guides/guest-access.md - Infrastructure: infrastructure.md
- Models: guides/models.md - Background: background.md
- What happens with your data: guides/what-happens-with-your-data.md - Working with the agent: working-with-the-agent.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: - Governance:
- Overview: governance/index.md
- Charter: governance/charter.md - Charter: governance/charter.md
- Code of conduct: governance/code-of-conduct.md - Code of conduct: governance/code-of-conduct.md
- Open questions: governance/open-questions.md - Open questions: governance/open-questions.md
- Terms of Service: governance/terms-of-service.md - Terms of Service: governance/terms-of-service.md
- Privacy Policy: governance/privacy-policy.md - Privacy Policy: governance/privacy-policy.md
- How to make a proposal: governance/make-a-proposal.md - How to make a proposal: governance/make-a-proposal.md
- Background: background.md
plugins: plugins:
# Built-in, offline search — the index is a JSON file in the build output. # Built-in, offline search — the index is a JSON file in the build output.
@@ -108,13 +95,6 @@ plugins:
"open-questions.md": "governance/open-questions.md" "open-questions.md": "governance/open-questions.md"
"terms-of-service.md": "governance/terms-of-service.md" "terms-of-service.md": "governance/terms-of-service.md"
"privacy-policy.md": "governance/privacy-policy.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: hooks:
# Rewrites directory-style links (e.g. [incidents/](incidents/)) to the # Rewrites directory-style links (e.g. [incidents/](incidents/)) to the
+19 -24
View File
@@ -14,7 +14,7 @@ provider today is best on both.
| Provider | Value | Privacy | Green energy | What that means | | 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. Please review the [Limitations on privacy](#limitations-on-privacy) below.| | **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. |
| **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. | | **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. | | **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,9 +37,6 @@ 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 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. 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:** **How to pick, quick guide:**
- **Default** → `greenpt/deepseek-v4.1-flash`: DeepSeek's efficient multimodal - **Default** → `greenpt/deepseek-v4.1-flash`: DeepSeek's efficient multimodal
@@ -81,23 +78,18 @@ 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 a zero-data-retention commitment). The 🌱 emoji marks renewable-powered
providers, not a specific company. providers, not a specific company.
| Model | Provider | Privacy | Green | Vision | Context | Pricing (EUR per 1M, in / out / cached) | Notes | | Model | Provider | Privacy | Green | Vision | Context | Pricing (in / out / cached) | Notes |
|---|---|---|---|---|---|---|---| |---|---|---|---|---|---|---|---|
| `🌱 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. | | `🌱 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). |
| `🔒 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/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/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. | | `🔒 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-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. | | `🌱 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/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.60 / €3.40 / — | Large vision+reasoning MoE (Qwen 3.5, 122B-A10B); 262K context. | | `🌱 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/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. | | `🌱 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 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 `/v1/chat/completions`, standard OpenAI format). In the chat UI, just attach
@@ -312,10 +304,13 @@ reports back, and appears in your usage record alongside your chat calls.
## Limitations on privacy ## Limitations on privacy
Only **Tinfoil** offers architectural privacy. GreenPT and Regolo are chosen for Only **Tinfoil** offers architectural privacy. The other providers are chosen
EU jurisdiction, contractual commitments and renewable energy, not for enclaves. for their value (renewable energy, public models) but do not run in enclaves —
Your **chat history**, whichever model you use, is stored on our server; the prompts and responses pass through them in the ordinary way. Your **chat
**API** path keeps usage records but no prompt or response text. The full account history** is also stored on our server so you can revisit it, and that stored
— what the gateway keeps, what each provider commits to, and what we do not history is not encrypted in a way that prevents us from technically reading it —
claim — is in [What happens with your data](what-happens-with-your-data.md). The we commit not to. Requests made through the **API** with your own key are a
formal policy is the [Privacy Policy](../governance/privacy-policy.md). 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).
-118
View File
@@ -1,118 +0,0 @@
# 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. | Read-only tools — web, vision, skills, memory, todo and session search. No terminal or file access. Flash/TEE models only, $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. | Standard toolset, confined to its own Unix account. Flash/TEE models 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. Flash/TEE models only, $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.
- **A nightly encrypted backup** of each agent's home, and a nightly mirror of
its configuration to 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
@@ -1,17 +0,0 @@
# 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.
-11
View File
@@ -1,11 +0,0 @@
# 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
@@ -1,28 +0,0 @@
# 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
@@ -1,22 +0,0 @@
# 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
@@ -1,32 +0,0 @@
# 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
+70 -52
View File
@@ -17,13 +17,12 @@ repository root.
| `logo.svg` | Co-op logo (shared with the website repo) | | `logo.svg` | Co-op logo (shared with the website repo) |
| `build.sh` | Stage the Markdown into `.site-src/`, render to `.site-build/` | | `build.sh` | Stage the Markdown into `.site-src/`, render to `.site-build/` |
| `hooks.py` | MkDocs hooks: directory-link rewriting + content-hashed stylesheet URLs | | `hooks.py` | MkDocs hooks: directory-link rewriting + content-hashed stylesheet URLs |
| `deploy.sh` | Manual publish of the build into the Surfer app (needs a Cloudron token) | | `deploy.sh` | Push the build into the Surfer app container |
| `poll-watcher.sh` | Legacy poller; no longer installed — superseded by the host-owned poller | | `poll-watcher.sh` | Polls Gitea main every 60s; deploys on change (agent host) |
| `docs-deploy-poll.service` | systemd unit for the poller (runs the host-owned script) | | `docs-deploy-poll.service` | systemd unit for the poller |
| `webhook-receiver.py` | Webhook receiver; not installed (see below) | | `webhook-receiver.py` | Gitea webhook → pull → build → deploy (agent host) |
| `webhook-receiver.service` | systemd unit for the receiver; not installed | | `webhook-receiver.service` | systemd unit for the receiver |
| `requirements.in` | Human-edited pins for the build toolchain | | `requirements.txt` | Pinned Python 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. Nothing external is loaded by the site: no CDN, no third-party font service.
Fonts are served from this repository's own output. Fonts are served from this repository's own output.
@@ -72,60 +71,79 @@ Override the destination with `SURFER_APP` (the app's Cloudron location) and
## Automatic rebuilds (push to main) ## Automatic rebuilds (push to main)
`docs-deploy-poll.service` polls Gitea every 60 seconds and deploys whenever Two mechanisms keep the site in step with `main`; both run on the agent host
`main` moves, so a push appears on the site within about a minute with no human and deploy into the docs Cloudron app above.
action. Edit, commit, push — that is the whole deployment story.
**The credential-bearing steps are host-owned, not repository code.** The **Polling (running now).** `docs-deploy-poll.service` polls Gitea every 60
poller runs a root-owned script (`/usr/local/sbin/docs-poll`) that does two seconds and deploys whenever `main` moves. A push appears on the site within
separate jobs: 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.
1. **Build as `docsbuild`.** The repository's build logic (`build.sh` → MkDocs The service builds from a **dedicated clean clone** at
→ `hooks.py`) runs as an unprivileged system user with a scrubbed `/home/ubuntu/.docs-publisher`, not from anyone's working copy, so uncommitted
environment, from its own clean clone at `/var/lib/docs-publisher/repo` edits in a working clone can never block a deploy. Edit, commit, push — that
with its own venv. That user cannot read `/home/ubuntu` (mode 750), so repo is the whole deployment story.
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).
A commit that lands on `main` therefore cannot execute anything with the **Webhook (wired, waiting on one port).** A Gitea webhook is registered on
Cloudron token. It can only influence the bytes of the site. `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:
**The webhook receiver is installed but not running.** `docs-deploy-webhook` ```sh
is inactive and nothing listens on 8787. It predates this split, loads the sudo systemctl enable --now docs-deploy-webhook
agent's env file, and runs repo scripts with the Cloudron token; do not enable tail -f /home/ubuntu/docs-deploy.log # what both mechanisms are doing
it without porting it to the same host-owned build/publish split. The Gitea ```
webhook registration is harmless while the receiver is down.
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.
Each deploy writes `meta.json` into the site with the commit it was built 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: from, so a deploy can be verified from the served site itself:
https://docs.inference.coop/meta.json https://docs.inference.coop/meta.json
If a deploy breaks, roll back with the saved unit ## One build environment (2026-11-12)
(`/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.
## Build environment 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:
`publishing/requirements.in` pins every package the build needs (`mkdocs`, - **ONE venv.** Every trigger — the poller, the (dormant) webhook receiver, a
`mkdocs-material`, `mkdocs-redirects`); `publishing/requirements.txt` is the manual `publishing/build.sh`, CI — builds with the canonical checkout's
generated hash-locked lockfile. `build.sh` verifies the build venv against venv: `~/repos/docs/.venv-docs`. The poller's private venv was deleted.
`requirements.in` before every build, installs from the lockfile with - **The dedicated checkout stays, by design.** The poller still builds from
`--require-hashes`, and fails loudly if `mkdocs.yml` configures a plugin that `/home/ubuntu/.docs-publisher`, its own clean clone: uncommitted edits in a
`requirements.in` does not pin. 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.
Regenerate the lockfile after editing pins: 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:
pip-compile --generate-hashes --strip-extras \ `flock -n ~/.docs-deploy.lock bash publishing/build.sh && flock -n
--output-file publishing/requirements.txt publishing/requirements.in ~/.docs-deploy.lock bash publishing/deploy.sh`.
```
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.
+11 -14
View File
@@ -2,10 +2,9 @@
# Build the member-readable documentation site from this repository. # Build the member-readable documentation site from this repository.
# #
# The repository is the single source of truth. This script: # The repository is the single source of truth. This script:
# 1. checks the build venv against publishing/requirements.in and # 1. checks the build venv against publishing/requirements.txt and
# self-heals anything missing or off-version (fast local no-op when # self-heals anything missing or off-version (fast local no-op when
# current — no network, a few `pip show` calls); installs from the # current — no network, a few `pip show` calls);
# hash-locked publishing/requirements.txt with --require-hashes);
# 2. checks that every plugin mkdocs.yml configures is pinned in # 2. checks that every plugin mkdocs.yml configures is pinned in
# requirements.txt (fails loudly naming any that is not); # requirements.txt (fails loudly naming any that is not);
# 3. stages a mirror of the documents into .site-src/ (generated, gitignored), # 3. stages a mirror of the documents into .site-src/ (generated, gitignored),
@@ -28,8 +27,8 @@
# # poller's pre-deploy check; also # # poller's pre-deploy check; also
# # cold-bootstraps the venv if absent) # # cold-bootstraps the venv if absent)
# #
# In CI (Woodpecker), install the hash-locked toolchain and run MkDocs directly: # In CI (Woodpecker), install the toolchain and run MkDocs directly:
# pip install --require-hashes -r publishing/requirements.txt && mkdocs build --strict # pip install -r publishing/requirements.txt && mkdocs build --strict
set -euo pipefail set -euo pipefail
@@ -42,8 +41,7 @@ if [ "${1:-}" = "--check-only" ]; then
shift shift
fi fi
VENV="${1:-$REPO_DIR/.venv-docs}" VENV="${1:-$REPO_DIR/.venv-docs}"
REQUIREMENTS_IN="$REPO_DIR/publishing/requirements.in" REQUIREMENTS="$REPO_DIR/publishing/requirements.txt"
REQUIREMENTS_LOCK="$REPO_DIR/publishing/requirements.txt"
# --- gate 1: pinned toolchain ---------------------------------------------- # --- gate 1: pinned toolchain ----------------------------------------------
# Compare the venv against the pinned requirements; install anything missing # Compare the venv against the pinned requirements; install anything missing
@@ -62,10 +60,10 @@ check_toolchain() {
if [ -z "$have" ] || { [ -n "$want" ] && [ "$have" != "$want" ]; }; then if [ -z "$have" ] || { [ -n "$want" ] && [ "$have" != "$want" ]; }; then
missing="$missing ${pkg}(${want:-any}; have: ${have:-none})" missing="$missing ${pkg}(${want:-any}; have: ${have:-none})"
fi fi
done < "$REQUIREMENTS_IN" done < "$REQUIREMENTS"
if [ -n "$missing" ]; then if [ -n "$missing" ]; then
echo "Self-heal: installing pinned toolchain package(s):$missing" echo "Self-heal: installing pinned toolchain package(s):$missing"
"$VENV/bin/pip" install --require-hashes -r "$REQUIREMENTS_LOCK" || { "$VENV/bin/pip" install -r "$REQUIREMENTS" || {
echo "FATAL: could not install the pinned toolchain into $VENV (network? disk?)" >&2 echo "FATAL: could not install the pinned toolchain into $VENV (network? disk?)" >&2
exit 1 exit 1
} }
@@ -118,20 +116,20 @@ PY
while IFS= read -r req; do while IFS= read -r req; do
case "$req" in ''|\#*) continue ;; esac case "$req" in ''|\#*) continue ;; esac
pinned="$pinned ${req%%[=<>!~]*}" pinned="$pinned ${req%%[=<>!~]*}"
done < "$REQUIREMENTS_IN" done < "$REQUIREMENTS"
for plug in $names; do for plug in $names; do
ok=0 ok=0
for cand in "$plug" "mkdocs-$plug"; do for cand in "$plug" "mkdocs-$plug"; do
case " $pinned " in *" $cand "*) ok=1 ;; esac case " $pinned " in *" $cand "*) ok=1 ;; esac
done done
if [ "$ok" = 0 ]; then if [ "$ok" = 0 ]; then
echo "FATAL: plugin '$plug' is configured in mkdocs.yml but NOT pinned in publishing/requirements.in." >&2 echo "FATAL: plugin '$plug' is configured in mkdocs.yml but NOT pinned in publishing/requirements.txt." >&2
echo " Add '<package>==<version>' there (usually mkdocs-$plug) so every build environment" >&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 echo " installs the same toolchain, then reinstall it in the build venv." >&2
return 1 return 1
fi fi
done done
echo "plugin check OK: configured plugin(s) $(echo "$names" | tr '\n' ' ') covered by requirements.in" echo "plugin check OK: configured plugin(s) $(echo "$names" | tr '\n' ' ') covered by requirements.txt"
return 0 return 0
} }
@@ -144,7 +142,7 @@ check_toolchain
check_plugins check_plugins
if [ "$CHECK_ONLY" = 1 ]; then if [ "$CHECK_ONLY" = 1 ]; then
echo "check OK: $VENV satisfies publishing/requirements.in and every configured plugin" echo "check OK: $VENV satisfies publishing/requirements.txt and every configured plugin"
exit 0 exit 0
fi fi
@@ -166,7 +164,6 @@ tar cf - \
--exclude='mkdocs.yml' \ --exclude='mkdocs.yml' \
--exclude='.gitignore' \ --exclude='.gitignore' \
--exclude='requirements.txt' \ --exclude='requirements.txt' \
--exclude='requirements.in' \
. | tar xf - -C "$SITE_SRC" . | tar xf - -C "$SITE_SRC"
# A file that must sit at the site root (crawler rules), not under publishing/. # A file that must sit at the site root (crawler rules), not under publishing/.
+22 -23
View File
@@ -1,42 +1,41 @@
# systemd unit for the docs auto-deploy poller (agent host). # systemd unit for the docs auto-deploy poller (agent host).
# #
# docs-deploy-poll.service ALWAYS ON. Polls Gitea every 60s; deploys on # docs-deploy-poll.service ALWAYS ON. Polls Gitea every 60s; deploys on
# any change to main. # any change to main. Works with the agent
# host's current firewall (outbound only).
# #
# docs-deploy-webhook.service INSTALLED, INACTIVE. It predates the # docs-deploy-webhook.service INSTALLED, INACTIVE UNTIL THE PORT IS OPEN.
# build/publish split, loads the agent's env # Instant push -> deploy once the Infomaniak
# file, and runs repo scripts with the Cloudron # panel allows inbound TCP to the agent host
# token. Do not enable it until it is ported to # (the Gitea webhook is already registered).
# the same split.
# #
# Install: # Install:
# sudo install -o root -g root -m 0644 publishing/docs-deploy-poll.service \ # sudo cp publishing/docs-deploy-poll.service /etc/systemd/system/
# /etc/systemd/system/docs-deploy-poll.service
# sudo systemctl daemon-reload # sudo systemctl daemon-reload
# sudo systemctl enable --now docs-deploy-poll # sudo systemctl enable --now docs-deploy-poll
# #
# The unit runs a HOST-OWNED script, /usr/local/sbin/docs-poll, which is not # poll-watcher.sh itself needs NO manual copy: the service runs the copy in
# copied from this repository. That script: # the dedicated checkout (/home/ubuntu/.docs-publisher), which git pull keeps
# * builds as the unprivileged `docsbuild` user from its own checkout at # at main on every deploy, and the watcher re-execs itself when a deploy
# /var/lib/docs-publisher/repo (a scrubbed environment, no read access to # changed it.
# /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).
# #
# Repo code (build.sh, hooks.py) therefore never executes with a credential. # ONE BUILD ENVIRONMENT: the poller builds from its own dedicated checkout
# See publishing/README.md. # (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.
[Unit] [Unit]
Description=Inference docs: poll Gitea main, build unprivileged, publish without repo code Description=Inference docs: poll Gitea main and deploy to Surfer
After=network-online.target After=network-online.target
Wants=network-online.target Wants=network-online.target
[Service] [Service]
User=root User=ubuntu
Environment=DOCS_REPO_DIR=/var/lib/docs-publisher/repo WorkingDirectory=/home/ubuntu/.docs-publisher
Environment=DOCS_DEPLOY_LOG=/var/log/docs-deploy.log Environment=DOCS_REPO_DIR=/home/ubuntu/.docs-publisher
ExecStart=/usr/local/sbin/docs-poll Environment=DOCS_CANONICAL_DIR=/home/ubuntu/repos/docs
ExecStart=/bin/bash /home/ubuntu/.docs-publisher/publishing/poll-watcher.sh
Restart=on-failure Restart=on-failure
RestartSec=10 RestartSec=10
-13
View File
@@ -1,13 +0,0 @@
# 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
+14 -599
View File
@@ -1,601 +1,16 @@
# Pinned build toolchain for the documentation site.
# #
# This file is autogenerated by pip-compile with Python 3.14 # EVERY package the build needs must be pinned here — this is not decoration:
# by the following command: # 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.
# #
# pip-compile --generate-hashes --output-file=req.lock --strip-extras req.in # Reproducible cold build:
# # python3 -m venv .venv-docs \
babel==2.18.0 \ # && .venv-docs/bin/pip install -r publishing/requirements.txt
--hash=sha256:b80b99a14bd085fcacfa15c9165f651fbb3406e66cc603abf11c5750937c992d \ mkdocs==1.6.1
--hash=sha256:e2b422b277c2b9a9630c1d7903c2a00d0830c409c59ac8cae9081c92f1aeba35 mkdocs-material==9.8.0
# via mkdocs-material mkdocs-redirects==1.2.3
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
@@ -0,0 +1,69 @@
# 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).