29 Commits
Author SHA1 Message Date
inference-admin abadbfef40 Merge pull request 'Terms: permit serving others through the co-op; state the notice and grace we actually give' (#10) from tos/institutional-use-and-termination-notice into main
Reviewed-on: co-op/docs#10
2026-11-22 00:14:06 +00:00
inference-admin 0ad009894c Updated date 2026-11-22 00:13:52 +00:00
inference-admin e72adad923 Merge pull request 'docs(agentic-systems): cover the whole agent fleet, not one bot' (#20) from docs/agentic-systems-fleet into main
Reviewed-on: co-op/docs#20
2026-11-21 16:46:09 +00:00
inference-bot d2440528cf docs(infrastructure): correct which account speaks in member rooms 2026-11-21 16:40:26 +00:00
inference-bot 34ade7a882 docs(agentic-systems): cover the whole agent fleet, not one bot 2026-11-21 16:39:59 +00:00
inference-bot 6183ac3f73 Merge pull request 'docs: make the Tinfoil encryption boundary precise' (#19) from docs/privacy-guide-precision into main 2026-11-21 16:26:23 +00:00
inference-bot 7e4ed4fac9 docs: make the Tinfoil encryption boundary precise
The gateway handles the prompt in memory before the Tinfoil proxy encrypts
it; say that, rather than implying the co-op never sees plaintext.
2026-11-21 16:26:16 +00:00
inference-bot e582a37c29 Merge pull request 'docs: gather privacy posture in one member-facing page' (#18) from docs/what-happens-with-your-data into main 2026-11-21 16:24:18 +00:00
inference-bot be0ca6c53b docs: gather privacy posture in one member-facing page
Adds guides/what-happens-with-your-data.md covering what the gateway,
chat server and each provider keep, why the routing path differs from a
marketplace router, and what the co-op does not claim.

Links it from Models, API access, Getting started, Guest access,
Infrastructure, the docs index, README and privacy policy. Fixes Getting
started's temporary-chat claim: temporary chats are server-backed and
deleted about an hour after creation, not never stored.
2026-11-21 16:24:00 +00:00
inference-admin 8d002bf5bc Merge pull request 'Document the agent-host access model' (#17) from docs/host-access-model into main
Reviewed-on: co-op/docs#17
2026-11-21 16:14:01 +00:00
inference-bot cb270e51b9 docs: document the host access model
State the privilege ranking on the Agentic Systems page: bots have no sudo, the steward can act only inside bot accounts, and root belongs to a separate key-only operator account. Update the Infrastructure page's least-privilege and backup statements to match.
2026-11-21 16:08:20 +00:00
inference-admin afbac0d805 Tweaks to the Working Group page 2026-11-20 05:12:45 +00:00
inference-admin 36d2d3c837 Added the approved Community WG description 2026-11-20 05:11:00 +00:00
inference-bot a9df31b287 docs: add Working Groups section under Operations, with Community page 2026-11-20 05:03:42 +00:00
inference-admin 695c6cfcf3 docs: keep infrastructure page navigational, not implementation detail 2026-11-20 02:12:31 +00:00
inference-admin 5ec2504426 docs: reflect restricted host access, signed key feed, backup versioning, advisory CI 2026-11-20 02:10:58 +00:00
inference-admin 20477174e5 security: hash-lock the docs build toolchain 2026-11-19 23:55:59 +00:00
inference-admin 279886fd83 security: use Gitea regexp CODEOWNERS rules 2026-11-19 23:52:30 +00:00
inference-admin eaaa615c73 security: CODEOWNERS for the publishing path and CI config 2026-11-19 23:52:03 +00:00
inference-bot 7dd072d245 Merge pull request 'docs(search): page fetching runs on co-op infrastructure' (#16) from search-fetcher into main 2026-11-19 23:07:32 +00:00
inference-admin 55f232e172 docs(search): page fetching runs on co-op infrastructure, not a third party 2026-11-19 23:07:06 +00:00
inference-bot 1f23ea1d78 Merge pull request #14: docs(search): describe the search and fetch pipeline 2026-11-19 22:36:44 +00:00
inference-admin a705a49495 ci: docs pipeline is secret-free and builds in an ephemeral venv; policy: untrusted text is data 2026-11-19 22:19:27 +00:00
inference-admin 5c23ec9310 Removed unnecessary index 2026-11-19 22:02:30 +00:00
inference-admin b39c9b9289 publishing: build without credentials, publish from a host-owned script
Repo build logic now runs as the unprivileged docsbuild user with a scrubbed
environment; the Cloudron token lives only in a root-owned publish script that
executes no repository code.
2026-11-19 21:51:05 +00:00
inference-admin f2e74564df Merge pull request 'Add guide: using the co-op privately from a local chat app' (#15) from bengansky/docs:local-chat-apps-guide into main
Reviewed-on: co-op/docs#15
Reviewed-by: Admin <info@inference.coop>
2026-11-19 21:32:03 +00:00
bengansky 03d32d2356 Add local chat apps guide to nav 2026-11-19 20:11:54 +00:00
bengansky 2ccf793644 Add guide: using the co-op privately from a local chat app
Walk-through for going from zero (no IC account/membership) to using IC-provided models on your own device (desktop or phone) via local apps.
2026-11-19 20:07:19 +00:00
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
23 changed files with 1317 additions and 255 deletions

No files matched your search

+22 -40
View File
@@ -1,33 +1,25 @@
# Woodpecker CI pipeline for co-op/docs — THIN on purpose. # Woodpecker CI pipeline for co-op/docs — THIN and SECRET-FREE on purpose.
# #
# It does NOT re-implement the build. The repository's publishing layer is the # It does NOT deploy. Publishing is host-side and split:
# single source of truth and this pipeline only wires it up:
# #
# publishing/requirements.txt pinned MkDocs + Material toolchain # /usr/local/sbin/docs-poll host-owned poller (root) — pulls main
# publishing/build.sh stage Markdown -> .site-src/, render .site-build/ # publishing/build.sh runs as the unprivileged `docsbuild` user,
# publishing/deploy.sh push .site-build/ into the Cloudron Surfer app # with no credentials and no access to
# /home/ubuntu
# /usr/local/sbin/docs-publish root-owned publish step — runs no repo code,
# holds the Cloudron token from a root-only file
# #
# Any change to how the site is built belongs in publishing/, never here. # CI exists only to prove the repository builds. It runs in a throwaway venv
# inside the pipeline workspace, never the agent image's shared /opt/docs-venv:
# a push to ANY repo must not be able to change a toolchain that another
# pipeline uses. No secret is wired into this pipeline, and none should be
# until the Woodpecker agent supports per-pipeline isolation.
# #
# Run model: MANUAL ONLY for now. The Gitea webhook that fires this on push is # Backend note: the co-op's Woodpecker agent is a Cloudron app with no Docker
# deliberately NOT wired — the poll watcher (docs-deploy-poll.service on the # socket, so it uses Woodpecker's `local` backend. Each step runs as a shell
# agent host) remains the live auto-deploy path until a manual run has proven # command INSIDE the agent container; the `image:` field selects the SHELL, not
# the pipeline. Once it has, add `push` to the `when` block below and register # a container image. That is exactly why this file must stay secret-free: the
# the webhook in Gitea. # container is shared by every pipeline.
#
# 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
@@ -36,17 +28,7 @@ steps:
- name: build - name: build
image: bash image: bash
commands: commands:
# Reuses the toolchain pre-installed in the agent image; build.sh only # Ephemeral toolchain per run — no shared venv, no /opt/docs-venv.
# creates/installs a venv if the one given is missing, which it is not. - python3 -m venv .ci-venv
- publishing/build.sh /opt/docs-venv - .ci-venv/bin/pip install -q --require-hashes -r publishing/requirements.txt
- 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
@@ -0,0 +1,8 @@
# Critical publishing path for the docs site.
# A change here runs repository code during the build (publishing/hooks.py,
# build.sh) and controls what gets deployed. Require an Owners review before
# merge — CODEOWNERS review enforcement is enabled on main.
# Gitea CODEOWNERS uses Go regexp (not glob); anchor each rule.
^publishing/.* @co-op/owners
^mkdocs\.yml$ @co-op/owners
^\.woodpecker\.yml$ @co-op/owners
+1
View File
@@ -13,6 +13,7 @@ funded through our [Open Collective](https://opencollective.com/inference-cooper
- **New here?** → [Getting started](guides/getting-started.md) — join, use the chat, and get involved in governance. - **New here?** → [Getting started](guides/getting-started.md) — join, use the chat, and get involved in governance.
- **Why does this exist?** → [Background](background.md) — a one-page summary of the mission and history. - **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](guides/models.md) — the full catalog of providers and models.
- **What happens to my data?** → [What happens with your data](guides/what-happens-with-your-data.md) — what the gateway, the chat server and each provider keep.
- **Want API access?** → [API access](guides/api-access.md) — use our models programmatically. - **Want API access?** → [API access](guides/api-access.md) — use our models programmatically.
- **What does it cost?** → [Pricing](guides/pricing.md) — dues, the monthly allowance, credit packs and what happens if dues stop. - **What does it cost?** → [Pricing](guides/pricing.md) — dues, the monthly allowance, credit packs and what happens if dues stop.
- **Want community chat?** → [Getting started · Matrix](guides/getting-started.md) — our federated Matrix server, including how to connect from any client and how to use an existing Matrix account. - **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.
+14 -14
View File
@@ -12,6 +12,9 @@
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
@@ -92,17 +95,15 @@ retention: deleted when you delete a saved chat, or about an hour after a
Temporary Chat is created. Operational details are in Temporary Chat is created. Operational details are in
[Infrastructure](../operations/infrastructure.md#chat-retention-and-web-search). [Infrastructure](../operations/infrastructure.md#chat-retention-and-web-search).
To read the pages behind the results, LibreChat sends the top result URLs to To read the pages behind the results, our own page-fetch service fetches the
**Keenable**, a third-party page-fetch service. We use Keenable's keyless public top result URLs. It runs on co-op infrastructure at fetch.inference.coop. The
endpoint, so its default data policy applies. Keenable logs and stores the service does not log the URLs or the page text and keeps no copy: the extracted
fetched URL, the page content, the returned results, and our server's IP address text goes to the model for that answer and is not stored by the fetcher. It
and user agent. Keenable's policy sets no fixed retention period. Keenable refuses private, loopback, and internal addresses, so it cannot be used to reach
processes data in the United States and in the countries where its service our own network. Your chat messages and account identity stay with us.
providers operate. Keenable may use content and usage data to improve and train
its products. Your chat messages and account identity stay with us.
Web search is optional. Leave the globe off for sensitive topics. If you need Web search is optional. Leave the globe off for sensitive topics. Note that the
search without a third-party page fetch, contact us about alternatives. search engines in §7 still receive your query when you use it.
## 6. What we do NOT do ## 6. What we do NOT do
@@ -118,8 +119,7 @@ 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.** DuckDuckGo and Brave receive your search queries (see §5).
- **Keenable.** This page-fetch service receives result URLs and page content Page fetching runs on co-op infrastructure, not at a third party.
(see §5).
## 8. Retention and deletion ## 8. Retention and deletion
@@ -132,8 +132,8 @@ The models we serve are provided by third parties that change over time, each wi
- Self-hosted on Cloudron (sandboxed apps, SSL, backups). - 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 uses the - Core infrastructure has no external dependencies. Web search sends queries
third-party services described in §5. to the search engines named in §5; page fetching runs on co-op infrastructure.
## 10. Your rights ## 10. Your rights
+6 -3
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
@@ -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).
@@ -83,7 +85,8 @@ Privacy is a core value, but it is **not uniform across the service** — and th
- 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
+3 -1
View File
@@ -34,7 +34,9 @@ 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: [privacy policy](../governance/privacy-policy.md). Full detail, including what we can and cannot see:
[What happens with your data](what-happens-with-your-data.md) and the
[privacy policy](../governance/privacy-policy.md).
## Get a key ## Get a key
+17 -16
View File
@@ -57,8 +57,8 @@ with the account you created in step 1.
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 base answers
on current web results. Searches use our self-hosted SearXNG instance and on current web results. Searches use our self-hosted SearXNG instance, and
Keenable, a third-party page-fetch service. See [what happens during a pages are read by our own fetcher. See [what happens during a
search](#what-happens-when-you-use-web-search). 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.
@@ -67,13 +67,14 @@ 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 kept on our servers - **Temporary chats** — for conversations you don't want in your history. Click
at all. Click the **Temporary Chat** toggle (in the chat header) and the the **Temporary Chat** toggle (in the chat header): the conversation is hidden
conversation is never saved: it disappears when you leave the page, and from your history immediately and deleted from our database about an hour
nothing lands in your history or our database. To make this your default, after creation. It still reaches our server while the chat runs, and it can
open **Settings → Conversations** and turn on **Default Temporary Chat**. remain in backups until they age out. To make this your default, open
For anything sensitive, we recommend a temporary chat — ideally paired with **Settings → Conversations** and turn on **Default Temporary Chat**. For
a 🔒 enclave model. See [Privacy](../governance/privacy-policy.md#4-what-we-can-see-an-honest-caveat)). anything sensitive, pair a temporary chat with a 🔒 enclave model. See
[What happens with your data](what-happens-with-your-data.md).
Your usage draws from your monthly allowance; you can see it on the 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).
@@ -93,14 +94,14 @@ Web search runs in two stages.
1. Our self-hosted **SearXNG** instance at 1. Our self-hosted **SearXNG** instance at
[search.inference.coop](https://search.inference.coop) sends your query to [search.inference.coop](https://search.inference.coop) sends your query to
**DuckDuckGo** and **Brave**. **DuckDuckGo** and **Brave**.
2. LibreChat sends the top result URLs to **Keenable**, a third-party 2. LibreChat sends the top result URLs to the co-op's **own page fetcher**. It
page-fetch service. Keenable reads each page and extracts its text. The model reads each page and extracts its text. The model receives those passages,
receives those passages, and the answer cites the sources. and the answer cites the sources.
SearXNG runs on co-op infrastructure. Keenable is an external service. The Both SearXNG and the page fetcher run on co-op infrastructure. The fetcher does
[privacy policy](../governance/privacy-policy.md#5-search) describes how not log the URLs or the page text and keeps no copy. The
Keenable handles fetched URLs and page content. Web search is optional. Leave [privacy policy](../governance/privacy-policy.md#5-search) describes this. Web
the globe off if you do not want pages fetched. 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
+2
View File
@@ -24,6 +24,8 @@ 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.
+1
View File
@@ -8,5 +8,6 @@ usage costs in energy and emissions.
- [Getting started](getting-started.md) — join, use the chat, and get involved in governance. - [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. - [Guest access](guest-access.md) — inviting someone without a full membership.
- [Models](models.md) — the catalogue of providers and models. - [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. - [API access](api-access.md) — use the models programmatically.
- [Energy & carbon](energy.md) — the energy and emissions behind the service. - [Energy & carbon](energy.md) — the energy and emissions behind the service.
+200
View File
@@ -0,0 +1,200 @@
# Using the co-op privately on your phone or computer
## Why use a local app
*A step-by-step walkthrough for members who aren't developers/super technical. Whole process takes about 15 minutes. Drafted for [co-op/support#56](https://git.inference.coop/co-op/support/issues/56).*
The co-op's web chat keeps your conversation history on the co-op's server. If you'd rather keep that history on your own phone or computer, you can talk to the same co-op models from a chat app installed on your device. Any app that accepts a custom "OpenAI-compatible" connection will work. This guide uses two free examples: **Jan** for computers and **Chatbox** for phones and computers.
> **What changes, and what doesn't**
>
> - **Changes:** your chat history is saved on your device, not on the co-op's server.
> - **Doesn't change:** every message still travels through the co-op's gateway to the model provider (Tinfoil, GreenPT or Regolo), exactly as in the web chat. The co-op records usage (which model, how many tokens, the cost), not what you wrote.
> - **You give up:** the web chat's document search and image tool, and history that syncs between your devices. Each device keeps its own chats.
### Which app should I use?
| | Jan | Chatbox |
| --- | --- | --- |
| Runs on | Mac (Apple silicon), Windows, Linux | iPhone, iPad, Android, Mac, Windows, Linux |
| Connecting to the co-op | Finds the co-op's models for you | You may need to type model names in |
| Running open models on your own computer | Built in | Needs a separate app |
| Cost | Free, no paid plans | Free with your co-op key; also sells its own optional plans |
| Open source | Yes, Apache 2.0 | Community Edition is GPL-3.0 |
**Rule of thumb:** on a phone, use Chatbox. On a computer, either works; Jan is a little easier to connect.
### What you need
- A phone, tablet or computer from the table above
- An email address
- A card or account you can pay dues with on Open Collective
- About 15 minutes
## Part 1. Join the co-op (everyone)
### Step 1. Become a member
1. Go to [inference.coop](https://inference.coop) and click **Become a member**.
2. Open Collective opens with $5/month filled in. Dues are a sliding scale: pay $5, or more if you can. Every member gets the same $15 of usage each month, whatever they pay.
3. Finish the checkout.
> **Important:** use the same email address here that you'll use for your co-op login. That's how the co-op knows you're a member.
### Step 2. Create your co-op login
1. Within a few minutes you'll get a **welcome email**. Check spam if it doesn't arrive.
2. Click the link in it and create your username and password.
You can now log in to the web chat and the Member Dashboard.
### Step 3. Make your API key
An **API key** is a long password that lets an app use your membership. It starts with `sk-`.
1. Go to [dashboard.inference.coop](https://dashboard.inference.coop) and log in.
2. Find the API keys section and create a new key. Give it a name you'll recognise, like `Jan_on_my_laptop` or `Chatbox_on_my_phone`. A separate key for each device lets you switch one off without affecting the others.
3. **Copy the key now** and keep it somewhere safe, such as your password manager.
> **Treat the key like a password.** Anyone who has it can spend your monthly allowance. Don't paste it into email, chat or shared documents. If it leaks, delete it in the dashboard and make a new one.
Now continue with [Part 2A for Jan](#part-2a-jan-on-a-computer) or [Part 2B for Chatbox](#part-2b-chatbox-on-a-phone-or-computer).
## Part 2A. Jan on a computer
### Jan step 4. Install Jan
1. Go to [jan.ai](https://jan.ai) and download Jan for your computer.
2. **Mac:** open the downloaded `.dmg` file and drag Jan into Applications. **Windows:** run the `.exe` installer. **Linux:** use the Flatpak (`flatpak install flathub ai.jan.Jan`) or the `.deb`/AppImage.
3. Open Jan. On first launch it asks whether to share anonymous usage data. It's off unless you say yes; choose whichever you prefer.
Jan is free and open source (Apache 2.0). You don't need a Jan account.
### Jan step 5. Connect Jan to the co-op
1. In Jan, open **Settings** (the gear), then **Model Providers**.
2. Click **Add Provider**.
3. Fill in the **Add Custom Provider** box exactly like this:
| Field | What to enter |
| --- | --- |
| API format | **OpenAI-compatible** |
| Provider name | `Inference Co-op` |
| Base URL | `https://gateway.inference.coop/v1` |
| API key | your `sk-…` key from Step 3 |
4. Click **Create**.
Jan now asks the co-op which models you can use and lists them under the new provider. If the list is empty, click the **refresh** icon next to **Models**.
> **Check the Base URL.** It must end in `/v1`, with nothing after it. Don't add `/chat/completions`.
### Jan step 6. Turn on tool access
Jan can't tell what each co-op model is able to do, so it treats every co-op model as plain chat. Until you switch on **Tools**, a model can't use Jan's web search or other tools, even when it wants to. When that happens, the reply can get stuck repeating "Let me search the web…" over and over.
1. Go to **Settings → Model Providers → Inference Co-op**.
2. Click the **pencil** next to a model you plan to use.
3. Under **Capabilities**, switch on **Tools**. Switch on **Vision** too if the model can read images.
4. Repeat for each model you use. The [model table](#which-model-should-i-use) shows which models support what.
### Jan step 7. Say hello
1. Start a **New Chat**.
2. Click the model name above the message box and choose a model under **Inference Co-op**. Not sure? Start with `deepseek-flash-green`, the web chat's default. A **tools** label next to a model means step 6 worked.
3. **Optional: let it search the web.** Click the **globe icon** in the toolbar under the message box. It reads **Web Search (Active)** when on. Only models with Tools switched on can use it.
4. Type a message and press Enter.
If an answer comes back, you're done. Your conversation is saved on your computer, in Jan.
> **Where your searches go.** Jan's web search doesn't run through the co-op. By default it uses a search service called Exa, which needs no key. You can choose a different service in **Settings → Web Search**.
## Part 2B. Chatbox on a phone or computer
### Chatbox step 4. Install Chatbox
1. **iPhone or iPad:** search for *Chatbox AI* in the App Store. **Android:** search in Google Play, or download the APK from [chatboxai.app](https://chatboxai.app). **Mac, Windows, Linux:** download the installer from [chatboxai.app](https://chatboxai.app).
2. Open Chatbox.
3. If it offers to sign you up for **Chatbox AI**, skip it. That's Chatbox's own paid model service. You don't need an account or a plan to use your co-op key.
> **Two kinds of AI in one app.** Chatbox sells its own models (Lite, Pro and Pro+ plans). This guide uses only the co-op's models, paid for by your membership. When you pick a model, make sure it's one listed under your co-op provider.
### Chatbox step 5. Connect Chatbox to the co-op
1. Open **Settings**, then **Model Provider**. On a phone, Settings is in the side menu.
2. Scroll to the bottom and tap **Add**.
3. Fill it in exactly like this:
| Field | What to enter |
| --- | --- |
| Name | `Inference Co-op` |
| API mode | **OpenAI API Compatible** |
| API Host | `https://gateway.inference.coop/v1` |
| API Path | leave empty |
| API Key | your `sk-…` key from Step 3 |
4. Tap **Check** next to the API Key. It should report a successful connection.
5. Tap **Fetch** to load the co-op's models, then select the ones you want to use. If Fetch doesn't work, add a model by hand by typing its name exactly, e.g. `deepseek-flash-green`.
6. Save.
> **Check the API Host.** It ends in `/v1`, with nothing after it. Don't add `/chat/completions`.
### Chatbox step 6. Turn on images and tools
Chatbox treats a model as text-only until you tell it otherwise.
1. Go back to **Settings → Model Provider → Inference Co-op**.
2. Open a model's settings.
3. Turn on the capabilities it supports, such as **vision** for reading images and **tool use**. The [model table](#which-model-should-i-use) shows which models support what.
### Chatbox step 7. Say hello
1. Go back to the main screen and start a **new chat**.
2. Tap the model name and choose a model under **Inference Co-op**. Not sure? Start with `deepseek-flash-green`, the web chat's default.
3. Type a message and send it.
If an answer comes back, you're done. Your conversation is saved on this device, in Chatbox.
**Using more than one device?** Repeat these steps on each one, ideally with its own key. Chats don't move between devices.
## Which model should I use?
All co-op models draw from the same $15 monthly allowance. They differ in **privacy**, **energy** and **cost**. If you're adding models by hand, copy these names exactly.
| If you care most about… | Use this alias | What it is | Vision |
| --- | --- | --- | --- |
| A good all-rounder, renewable energy | `deepseek-flash-green` | The web chat's default model. Policy-based privacy. | ✓ |
| The same model with strong privacy | `deepseek-flash-tee` | Runs inside attested, encrypted hardware (confidential computing). Supports tools. | ✓ |
| Fast and inexpensive, renewable energy | `glm-flash-green` | A quick GLM model. Policy-based privacy. | |
| The strongest model, with strong privacy | `glm-tee` | GLM flagship in confidential computing. | |
These are the co-op's **stable aliases**. When a provider retires or replaces a model, the co-op points the alias at its successor, so your app keeps working without changes. The `-green` aliases run on renewable energy; the `-tee` aliases run the same model family in confidential-computing hardware. A blank Vision cell means the co-op doesn't document it. If you want a specific model instead, such as Regolo's zero-retention models, use its full name from the [models page](https://docs.inference.coop/guides/models/).
> **Which models can use tools (web search and other add-ons)?** Switch on Tools only for models that support it.
>
> - **Documented by the co-op:** `deepseek-flash-tee` (`tinfoil/deepseek-v4-1-flash`), `regolo/gemma4-31b` and `regolo/mistral-small-4-119b`.
> - **Worked in a member's test in Jan:** `greenpt/glm-5.3`, the strongest model in the green tier.
> - **Not documented yet:** `deepseek-flash-green`, `glm-flash-green` and `glm-tee`. Try them with Tools on; if you get errors or odd replies, switch Tools off for that model.
## Keeping an eye on your allowance
The [Member Dashboard](https://dashboard.inference.coop) shows how much of your $15 is left this month. Neither app shows it. The allowance resets on the day of the month you joined. If you run out, you can buy co-op credit packs, which never expire. You don't need Chatbox's own plans.
## If something goes wrong
| What you see | App | What it usually means | Fix |
| --- | --- | --- | --- |
| Error **401** or **403**, or Check fails | Both | The app isn't sending a valid key | Re-paste the key in the co-op provider's settings. Check there are no spaces at either end. |
| Error **404** on every message | Jan | The Base URL is wrong | Make it exactly `https://gateway.inference.coop/v1`. |
| Error **404** on every message | Chatbox | The API Host is wrong | API Host `https://gateway.inference.coop/v1` with API Path empty. If that still fails, try API Host `https://gateway.inference.coop` with API Path `/v1/chat/completions`. |
| No models listed | Jan | Jan couldn't fetch the list | Click the refresh icon next to Models, or click **+** and type a model name, e.g. `deepseek-flash-green`. |
| Fetch finds no models | Chatbox | Chatbox couldn't load the list | Add a model by hand, e.g. `deepseek-flash-green`. |
| "Model not found" | Both | A typo in the model name | Copy the name from the model table. |
| Messages fail straight away | Both | Wrong API format | Edit the provider and choose OpenAI-compatible. |
| The reply keeps repeating "Let me search…" or shows stray `</think>` tags | Both | The model is trying to use a tool it hasn't been given | Stop the reply, then switch on Tools for that model (Jan step 6 or Chatbox step 6) and try again. |
| Replies come from a model you didn't expect | Chatbox | You picked a Chatbox AI model | Choose a model listed under **Inference Co-op**. |
| A message says your balance is out | Both | You've used this month's $15 | Wait for your reset date, or buy a co-op credit pack. |
Still stuck? Ask in the co-op's Skillshare room on Matrix, open an issue on the [support tracker](https://git.inference.coop/co-op/support/issues), or email info@inference.coop.
*Written against Jan 0.8.8's documentation (October 2026), Chatbox's documentation and a third-party Chatbox setup guide (Vercel, September 2026). The Jan steps have been tested by a member; the Chatbox steps haven't yet. Menu names can change between app versions and between phone and desktop.*
+10 -10
View File
@@ -37,6 +37,9 @@ Trade-offs are real: the most private option (Tinfoil) isn't the greenest, and
the greenest option (GreenPT) isn't the most private. The point of the co-op is 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
@@ -309,13 +312,10 @@ reports back, and appears in your usage record alongside your chat calls.
## Limitations on privacy ## Limitations on privacy
Only **Tinfoil** offers architectural privacy. The other providers are chosen Only **Tinfoil** offers architectural privacy. GreenPT and Regolo are chosen for
for their value (renewable energy, public models) but do not run in enclaves — EU jurisdiction, contractual commitments and renewable energy, not for enclaves.
prompts and responses pass through them in the ordinary way. Your **chat Your **chat history**, whichever model you use, is stored on our server; the
history, including when using Tinfoil**, is also stored on our server so you can **API** path keeps usage records but no prompt or response text. The full account
revisit it, and that stored history is not encrypted in a way that prevents us — what the gateway keeps, what each provider commits to, and what we do not
from technically reading it — we commit not to. Requests made through the **API** claim — is in [What happens with your data](what-happens-with-your-data.md). The
with your own key are a different matter: those are **not stored on our side at formal policy is the [Privacy Policy](../governance/privacy-policy.md).
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).
+146
View File
@@ -0,0 +1,146 @@
# What happens with your data?
A request passes through up to three layers, and each has a different
guarantee:
1. **Our gateway** routes the request and records what it cost.
2. **The model provider** runs the model.
3. **The chat server** saves the conversation, if you are using chat.
This page brings the privacy details together. The formal commitments are in
the [Privacy Policy](../governance/privacy-policy.md).
## The short version
- **In chat**, your conversation is stored on our server so you can revisit it.
Temporary chats are the exception: hidden from your history immediately,
deleted about an hour after creation, and only recoverable from backups until
those backups age out.
- **Through the API**, our gateway keeps a usage record and no text: the model,
token counts, cost, and which key made the request.
- **At the provider**, protection depends on the model you choose. Tinfoil runs
inference inside hardware enclaves. GreenPT and Regolo run in the EU under
GDPR, and Regolo's zero-retention claim is independently certified.
- We do not train on your data or sell it.
## The router: what it sees and what it keeps
The gateway is **LiteLLM**, running on the co-op's own server in Switzerland. It
has to handle your prompt in memory to send it to the provider. It does not
write prompts or responses to its logs or database. What it keeps is the usage
record that meters your allowance.
We test that instead of asserting it. A request containing a distinctive marker
is sent through the gateway, then the marker is searched for in the gateway's
logs, its request records, and its logging configuration. The marker does not
appear; the records carry usage fields only. The gateway's configuration and
code are public at [code/litellm](https://git.inference.coop/code/litellm), so
the logging settings can be read directly.
Two limits on that statement, because it is easy to read as more than it is:
- The gateway still knows **that a given key made a request**, and therefore
which member it belongs to. That link is how metering works.
- **"Not stored by us" is not "not stored."** What the provider keeps is a
separate question, answered in the next section.
## Why this is not a marketplace router
A common AI router sits in a chain: your request goes through the router, then
possibly another router, then a marketplace seller, then the provider. Every hop
can see the prompt, and some marketplaces retain prompts through ordinary
platform logging.
Our path has one hop we operate:
**Your client or our chat → our gateway → the provider.**
There is no marketplace, no reseller, and no second router in the path. We
contract each provider directly. Fewer parties handling the request means fewer
places it can be copied.
That is a reduction in exposure, not a guarantee about any provider. Dragos
researchers sent roughly two million prompts containing canary tokens through
commercial AI services and found prompt theft at marketplace resellers, providers
ignoring privacy settings, and breaches at three hosting providers — including
large ones
([their write-up](https://www.dragos.com/blog/ai-supply-chain-security-canary-tokens)).
Size is not the safeguard. Verifiable commitments, fewer intermediaries, and the
law are.
## What the providers keep
| Provider | Runs where | What is committed | Basis |
|---|---|---|---|
| **Tinfoil** | United States | Prompts and responses are not retained after the response is returned, apart from temporary prompt caching in encrypted enclave memory. Once the request reaches the enclave, neither Tinfoil nor the co-op can read it in plaintext; our gateway still handles it in memory before encrypting. | Hardware enclaves, verifiable through remote attestation — a technical guarantee, not only a policy. |
| **GreenPT** | EU data centres in France and Finland | API payloads are processed in memory only and not stored. Error logs and monitoring metrics contain no prompt content. A DPA is available; its model-hosting sub-processors are in Finland. | EU jurisdiction, GDPR, and a contractual DPA. Policy-based: protection depends on GreenPT keeping its commitments. |
| **Regolo** (Seeweb S.r.l.) | Italy, EU | Prompts and outputs are not stored, logged, or reused for training. General account and connection metadata is still covered by its privacy policy. | EU jurisdiction and GDPR, plus a zero-data-retention certificate issued by an independent auditor on 24 July 2026. Policy-based with an external audit. |
Sources: [Tinfoil's terms](https://tinfoil.sh/terms),
[GreenPT's privacy policy](https://greenpt.com/privacy-policy), and
[Regolo's zero-data-retention page](https://regolo.ai/zero-data-retention/).
**Architectural versus policy-based.** An enclave protects you even if the
provider is compromised, because the provider cannot read the plaintext. A
policy protects you only as far as the provider keeps its word and the law is
enforced. Regolo's independent audit makes its policy claim checkable; GreenPT's
DPA and EU location give you a legal route if it is broken. Neither is the same
as cryptography.
## What the co-op can still see
- **Which member made a request.** Gateway usage records link a request to a key
and therefore to an account. This is how metering and budgets work.
- **Chat history.** Saved conversations sit in the chat database and its search
index, which the co-op can technically read. We commit not to; that is a policy
commitment, not an architectural guarantee. Temporary chats reduce the window
but do not remove the operator's technical access while the chat exists.
- **Operational logs.** Account provisioning, welcome emails, errors and access
logs contain the email addresses and connection metadata needed to run the
service. They are kept briefly and are not used to profile members.
- **Backups.** Cloudron takes whole-app encrypted backups nightly and keeps
seven days. A temporary chat present when a backup runs can remain recoverable
until that backup expires.
## Retention at a glance
| What | How long |
|---|---|
| Saved chats and their search entries | Until you delete them |
| Temporary chats | Hidden immediately; deleted from the database about an hour after creation; may persist in backups until they expire |
| API prompts and responses | Not stored by the co-op; provider retention is per the table above |
| Usage records (model, tokens, cost, key) | Kept for billing and account administration |
| Web-search queries | Stored with the conversation; DuckDuckGo and Brave receive the query when you use search |
| Operational logs | Kept briefly for running and debugging the service |
## What we do not claim
- **We do not claim "we never see your messages."** The gateway sits between you
and the provider by design, so prompts pass through it in memory.
- **Privacy is not uniform across the catalogue.** Only Tinfoil offers
architectural privacy. GreenPT and Regolo are chosen for EU jurisdiction,
contractual commitments and renewable energy, not for enclaves.
- **A temporary chat does not change who processes the request.** The model you
choose still receives your messages.
- **EU law is a constraint, not a force field.** GDPR gives you rights and a
complaints route; it does not make misuse impossible.
## Check it yourself
- Read the gateway configuration and patch history at
[code/litellm](https://git.inference.coop/code/litellm).
- Check Tinfoil's attestation documents, Regolo's zero-retention certificate,
and GreenPT's DPA against the links above.
- Ask us to repeat the marker test on the live gateway. Write to
[info@inference.coop](mailto:info@inference.coop) and we will run it and report
what we find.
## Formal policy and provider terms
- [Privacy Policy](../governance/privacy-policy.md) — the co-op's formal policy,
including your rights and how to request deletion.
- [Terms of Service](../governance/terms-of-service.md) — acceptable use and the
commitments that apply to members.
- Provider terms: [Tinfoil](https://tinfoil.sh/terms),
[GreenPT](https://greenpt.com/terms-of-service),
[Regolo](https://regolo.ai/terms/).
+5
View File
@@ -71,9 +71,11 @@ nav:
- Guides: - Guides:
- Overview: guides/index.md - Overview: guides/index.md
- Getting started: guides/getting-started.md - Getting started: guides/getting-started.md
- Local chat apps: guides/local-chat-apps.md
- Pricing: guides/pricing.md - Pricing: guides/pricing.md
- Guest access: guides/guest-access.md - Guest access: guides/guest-access.md
- Models: guides/models.md - Models: guides/models.md
- What happens with your data: guides/what-happens-with-your-data.md
- API access: guides/api-access.md - API access: guides/api-access.md
- Energy & carbon: guides/energy.md - Energy & carbon: guides/energy.md
- Operations: - Operations:
@@ -82,6 +84,9 @@ nav:
- Infrastructure: operations/infrastructure.md - Infrastructure: operations/infrastructure.md
- Roles: operations/roles.md - Roles: operations/roles.md
- Steward Policy: operations/steward-policy.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 - Overview: governance/index.md
- Charter: governance/charter.md - Charter: governance/charter.md
+90 -41
View File
@@ -1,44 +1,82 @@
# Working with the agent # Agentic systems
The co-op runs **Inferencebot** to help steward its infrastructure. It is The co-op runs a small fleet of autonomous agents. Each is a separate Unix
isolated as its own OS user, with its own gateway key — budget, model account with its own Hermes install, gateway unit, Matrix identity and gateway
allowlist and spend enforced at the gateway. It runs on co-op infrastructure key. None of them is a general-purpose assistant for members: each has a
under a co-op identity, uses the co-op's own gateway for inference, and its defined job, a defined room, and a ceiling on what it can reach. Root belongs
skills, scripts and configuration are mirrored to a Gitea repository nightly. to a person.
This page is for members who read its output or give it instructions.
## Where it speaks and listens All four are on the co-op's Matrix server, `matrix.inference.coop`.
- **#inferencebot-updates** is read-only: daily digests, model changes, ## The agents today
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 | Agent | Job | Where it works | Who may instruct it | Access ceiling |
| --- | --- | --- | --- | --- |
| **Inferencebot** — steward (`@inferencebot`) | Runs the stack day to day: monitoring and digests, membership plumbing, docs and repo changes, backups. | The operator's HQ room only. | The General Manager and one named account; mention required. | Full toolset; all gateway models on the co-op's internal account team. Holds the Cloudron, Gitea, Matrix-admin and gateway-master credentials. Can enter each bot account through a named sudo rule; no root. |
| **infrastructure-bot** (`@infrastructure-bot`) | Infrastructure & Engineering Working Group assistant: diagnoses status, drafts runbook steps and issues, reports findings. | `#infrastructure`, restricted to co-op members. | Anyone in that room; mention required. | Reading and answering tools — web, vision, skills, memory, todo and session search. No terminal or file access. A fixed GreenPT/Tinfoil allowlist (GLM 5.3 and DeepSeek flash tiers), $5 per 30 days. Holds only its own gateway key and Matrix token. |
| **socialbot** (`@socialbot`) | Drafts and publishes the co-op's AT Protocol (Bluesky) posts; watches mentions and replies read-only. | `#social-drafts`, invite-only and deliberately outside the Space. | The General Manager and Inferencebot. Publishing needs a 👍 reaction from the General Manager on that exact draft. | Default Hermes toolset, confined to its own Unix account. GreenPT/Tinfoil allowlist plus image generation, $5 per 30 days. Holds a post-scoped Bluesky app password, its gateway key and Matrix token. |
| **designbot** (`@designbot`) | Design Working Group assistant: design and branding, diagrams and docs visuals, Penpot files, commits to the docs repo. | DesignBot Studio, invite-only and deliberately outside the Space. | The General Manager and the Design Working Group steward; mention required. | Web, vision, skills, memory, todo, session search, terminal and file tools. GreenPT/Tinfoil allowlist (GLM 5.3 and DeepSeek flash tiers), $5 per 30 days. Holds a Penpot token and MCP key, and a Gitea account with write access to `co-op/docs` only. |
- Operational work that a runbook already describes, or that ends in a PR, an The Community and Compute working groups have no agent today. A new
issue or a post members can see. working-group agent is provisioned to the same shape: its own Unix account,
- Research and summaries that would otherwise land in an issue. gateway unit, gateway key and studio room outside the co-op Space.
- Status: what is running, what failed, what changed.
## What not to ask in a shared room ## What every agent shares
- Anything involving member-identifying data. That work happens in a session a - **One Unix account each**, with a home directory readable only by that
named steward opened, and the result is reported without the data. account. The bots cannot use `sudo` at all; their gateway units run with
- Anything that moves money or changes who is a member. Those go through the `NoNewPrivileges` and a private temporary directory.
portal and a human. - **Its own gateway key.** The model allowlist and budget are enforced at
- Credentials, in either direction. LiteLLM, the co-op's gateway — not in the agent's prompt — so an agent cannot
spend past its allowance or call a model it was not granted. Spend is
attributed to the agent that incurred it.
- **No member records.** Confidential member data stays on the primary server.
A compromise of an agent host exposes keys, not member data.
- **The agent host is backed up nightly**, encrypted, off the box. The steward's
own configuration is also mirrored nightly to `ops/inferencebot` in Gitea.
- **No room outside its allowlist.** The room check runs before any mention
logic, so an `@mention` in the wrong room is dropped unread.
## The permission ladder
1. **Root belongs to a person.** The separate `operator` account, reached by
SSH key and never a password, holds full `sudo`. Root SSH login stays closed.
2. **Inferencebot, the steward,** is the fleet administrator. It can enter each
bot account through a named sudo rule, and can start the docs and backup
services. It has **no root**: it cannot install packages, create users, edit
`/etc`, or open a root shell.
3. **The bots** have no `sudo`, no Cloudron token, no gateway master key, and no
path into another agent's home.
That split is deliberate. An agent compromise reaches the bot accounts and the
co-op plumbing, not the host. Host-level actions stay attributable to a human,
and automation cannot quietly widen its own privileges.
## Who can instruct them
- **Every agent requires a mention.** None answers on ambient room chatter.
- **The steward answers only in the operator's HQ room**, and only to the
General Manager and one other named account. Member-facing digests are posted
by the room-admin account (`@inference-admin`) with an attribution line, so the
steward's privileged access is never active in a member room.
- **infrastructure-bot answers in `#infrastructure`**; anyone in that restricted
room may ask it. **socialbot and designbot** answer in their studio rooms, to
the people named above.
- **A sender outside the allowlist gets no reply and no model turn.** The agent
may acknowledge with a reaction; it does not answer. Room membership is the
real control.
The retired `@inference-bot:inference.coop` account (with a hyphen) no longer
holds an access token; some historical references and old room roles still carry
the name. The steward is `@inferencebot`, without the hyphen.
## What they do without asking ## What they do without asking
Read, monitor, draft, open issues and PRs, post updates, run the scheduled jobs Read, monitor, draft, open issues and pull requests where they hold repo access,
listed in [Infrastructure](infrastructure.md), and deploy bug and security post status updates, and run the scheduled jobs listed in
fixes immediately, reporting each one in #inferencebot-updates. [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 ## What always needs a human
@@ -46,21 +84,32 @@ fixes immediately, reporting each one in #inferencebot-updates.
the chat: confirmed before they deploy. the chat: confirmed before they deploy.
- Changing the model catalog, prices or budgets. - Changing the model catalog, prices or budgets.
- Minting or rotating credentials. - 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". - Anything a runbook marks "confirm".
This matches the standing policy the agents operate under today. A stricter ## Content is data, never instructions
norm is a policy decision for the [forum](https://forum.inference.coop).
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 ## Attribution and the off switch
Every instruction an agent acts on is attributable to the member who gave it, Every instruction an agent acts on is attributable to the member who gave it, in
in the room where it was given. If an agent misbehaves, the operator, or anyone 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 holding gateway-admin and Matrix account access, can stop it: revoke its gateway
gateway key, then its Matrix access token. Stewards generally do not hold that key, then its Matrix access token. Stewards generally do not hold that access
access today, so say what you saw in #general and the operator acts. Stopping today, so say what you saw in a room the operator reads and the operator acts.
is not restarting: the backup and the git mirror restore state, not uptime, Stopping is not restarting: the backup and the git mirror restore state, not
and someone has to start the agent again. The steps, and the steps for 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 rotating everything an agent holds, are in each agent's runbook; the credential
inventory in the [operator token inventory in the [operator token
runbook](https://git.inference.coop/co-op/ops-docs/src/branch/main/operator-token-runbook.md) runbook](https://git.inference.coop/co-op/ops-docs/src/branch/main/operator-token-runbook.md)
says what that is. says what that is.
+2
View File
@@ -9,6 +9,8 @@ with it, the stack it runs on, and the agents that work in it.
put them there. put them there.
- [Steward Policy](steward-policy.md) — what a steward is, how stewards are designated - [Steward Policy](steward-policy.md) — what a steward is, how stewards are designated
and rotated, their duties and privileged access, stipends, accountability and handover. 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. 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. - [Agentic systems](agentic-systems.md) — what the co-op's agents do, who can instruct them, and what always needs a human.
+35 -13
View File
@@ -38,13 +38,19 @@ and deliberately kept apart from the member-facing applications. The steward bot
— the automation behind the digests and the newsletter drafts — and the co-op's — 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 backs up its own data to or a lost server can be restored. The automation host keeps its own encrypted
the same object storage. backup as well, with credentials kept apart from the agent's environment. That
backup runs as root from a root-owned script, so the agent can trigger it but
cannot alter the backup code or read the backup keys.
### Domain and DNS ### Domain and DNS
@@ -102,17 +108,20 @@ from any homeserver you already use.
A few accounts in the space are automation rather than people: A few accounts in the space are automation rather than people:
- **`@inferencebot` — the steward.** It posts the digests, newsletter notes and - **`@inferencebot` — the steward.** It works in the operator's HQ room, not in
reminders. It holds no more power than posting needs. the member rooms, and holds the steward credentials. Member-facing messages
that come from its work are posted by `@inference-admin`, and say so in the
message.
- **`@inference-admin`** — the administrator of record for the co-op's rooms - **`@inference-admin`** — the administrator of record for the co-op's rooms
(#general, #community, #design, #skillshare, #updates and #infrastructure) and (#general, #community, #design, #skillshare, #updates and #infrastructure) and
their membership. It **never speaks in a member room** — a message from it is their membership. It also posts member-facing digests on the steward's behalf,
a mistake, not a feature. with an attribution line naming the steward.
The house rule: **power belongs to `@inference-admin`, voice belongs to The house rule: **room power and membership belong to `@inference-admin`; the
`@inferencebot`.** Please don't create an account whose name differs from an steward's own voice stays in HQ, and anything it sends to a member room carries
existing one by a character or two — spotting lookalikes is exactly what this the admin account's attribution.** Please don't create an account whose name
convention is for. differs from an existing one by a character or two — spotting lookalikes is
exactly what this convention is for.
## Membership ## Membership
@@ -193,6 +202,9 @@ 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 can remain recoverable from that backup until the backup itself expires (see
[Backups](#backups)). [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 **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 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 upstream engines see the query but not the member's IP or identity. The SearXNG
@@ -201,9 +213,11 @@ 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 no member identity or IP, and are retained only briefly. The reverse proxy does
not log search queries. not log search queries.
LibreChat reads the pages behind the results through **Keenable**, a third-party LibreChat reads the pages behind the results through the co-op's **own
page-fetch service. Keenable's logging and retention are described in the page-fetch service** (`fetch.inference.coop`), a small app on our Cloudron. It
[privacy policy](../governance/privacy-policy.md#5-search). 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)
@@ -213,10 +227,18 @@ page-fetch service. Keenable's logging and retention are described in 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
+22
View File
@@ -0,0 +1,22 @@
# Community Working Group
The Community Working Group is responsible for cultivating an active and healthy community life within the co-op. This includes organizing events for both members and the broader public, supporting mutual learning among members around our technological and social values, managing the co-op's social media presence, and helping welcome new and prospective members.
Participation: Open to any member of Inference Cooperative.
Meeting Frequency: Monthly Online
**Roles and Responsibilities**
* Steward(s): Facilitate meetings, support communication, and help coordinate group activities.
* Members: Participate in discussions, share knowledge and expertise, and collaborate on agreed-upon activities.
*The above scope was [approved by the membership 2026.11.19](https://forum.inference.coop/p/ICNzQfdk/proposed-working-group-community-working-group/0).*
## Where to take part
The working group's day-to-day discussions occur at **#community:inference.coop** on the co-op's Matrix server.
## Leadership
The Community Working Group's steward is Isabela Barbosa (`@isabelabs` on Matrix). Learn more about the co-op's roles [here](../roles.md).
+32
View File
@@ -0,0 +1,32 @@
# Working Groups
Working groups are where members carry out the co-op's operational work. Each
group makes and carries out decisions in its own area, and answers to members by
publishing what it does. The [Charter](../../governance/charter.md#roles) gives them
their authority and their obligations.
## What every working group owes members
- It publishes its **purpose, meeting schedule and major activities** to
members.
- At least one member takes part in the **spokescouncil**, which coordinates
across the groups and meets monthly. Its meetings are open to all members.
- It is established, changed or disbanded through a **policy decision** of the
members.
The [Steward Policy](../steward-policy.md) sets out how a steward leads a group:
open participation, shared credit, visible plans, and a seat on the spokescouncil.
## The groups
- [Community Working Group](community.md) — steward Isabela Barbosa (`@isabelabs`).
- Design Working Group — steward Juan Fortun (`@juanfortun`).
- Infrastructure & Engineering Working Group — steward Angel Marino (`@solo.ist`).
- Compute Working Group — steward Tara Merk (`@mpg`).
Each steward was appointed under the
[Steward Policy](../steward-policy.md). The [Roles](../roles.md) page records the
appointments and their basis.
Pages for the other groups will follow as each group publishes its work and explains
how to get involved
+52 -70
View File
@@ -17,12 +17,13 @@ repository root.
| `logo.svg` | Co-op logo (shared with the website repo) | | `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` | Push the build into the Surfer app container | | `deploy.sh` | Manual publish of the build into the Surfer app (needs a Cloudron token) |
| `poll-watcher.sh` | Polls Gitea main every 60s; deploys on change (agent host) | | `poll-watcher.sh` | Legacy poller; no longer installed — superseded by the host-owned poller |
| `docs-deploy-poll.service` | systemd unit for the poller | | `docs-deploy-poll.service` | systemd unit for the poller (runs the host-owned script) |
| `webhook-receiver.py` | Gitea webhook → pull → build → deploy (agent host) | | `webhook-receiver.py` | Webhook receiver; not installed (see below) |
| `webhook-receiver.service` | systemd unit for the receiver | | `webhook-receiver.service` | systemd unit for the receiver; not installed |
| `requirements.txt` | Pinned Python build toolchain | | `requirements.in` | Human-edited pins for the build toolchain |
| `requirements.txt` | Hash-locked toolchain generated from `requirements.in` |
Nothing external is loaded by the site: no CDN, no third-party font service. 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.
@@ -71,79 +72,60 @@ Override the destination with `SURFER_APP` (the app's Cloudron location) and
## Automatic rebuilds (push to main) ## Automatic rebuilds (push to main)
Two mechanisms keep the site in step with `main`; both run on the agent host `docs-deploy-poll.service` polls Gitea every 60 seconds and deploys whenever
and deploy into the docs Cloudron app above. `main` moves, so a push appears on the site within about a minute with no human
action. Edit, commit, push — that is the whole deployment story.
**Polling (running now).** `docs-deploy-poll.service` polls Gitea every 60 **The credential-bearing steps are host-owned, not repository code.** The
seconds and deploys whenever `main` moves. A push appears on the site within poller runs a root-owned script (`/usr/local/sbin/docs-poll`) that does two
about a minute, with no human action. The Gitea webhook alone was not enough separate jobs:
because the agent host's cloud firewall only admits inbound SSH — a webhook
POST is silently dropped — while outbound access to Gitea works.
The service builds from a **dedicated clean clone** at 1. **Build as `docsbuild`.** The repository's build logic (`build.sh` → MkDocs
`/home/ubuntu/.docs-publisher`, not from anyone's working copy, so uncommitted → `hooks.py`) runs as an unprivileged system user with a scrubbed
edits in a working clone can never block a deploy. Edit, commit, push — that environment, from its own clean clone at `/var/lib/docs-publisher/repo`
is the whole deployment story. with its own venv. That user cannot read `/home/ubuntu` (mode 750), so repo
code cannot see any co-op credential — the Cloudron token, the gateway
master key, the agent's env file.
2. **Publish with a root-owned script.** `/usr/local/sbin/docs-publish` runs
no repository code. It takes only the built directory, writes `meta.json`,
and pushes it into the Surfer app using `CLOUDRON_TOKEN` from
`/etc/docs-deploy.env` (root-only, mode 0600).
**Webhook (wired, waiting on one port).** A Gitea webhook is registered on A commit that lands on `main` therefore cannot execute anything with the
`co-op/docs` (push events, branch `main`) pointing at the receiver below. The Cloudron token. It can only influence the bytes of the site.
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:
```sh **The webhook receiver is installed but not running.** `docs-deploy-webhook`
sudo systemctl enable --now docs-deploy-webhook is inactive and nothing listens on 8787. It predates this split, loads the
tail -f /home/ubuntu/docs-deploy.log # what both mechanisms are doing agent's env file, and runs repo scripts with the Cloudron token; do not enable
``` it without porting it to the same host-owned build/publish split. The Gitea
webhook registration is harmless while the receiver is down.
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
## One build environment (2026-11-12) If a deploy breaks, roll back with the saved unit
(`/root/docs-deploy-poll.service.before-split`) and the previous build in
`/var/lib/docs-publisher/repo/.site-build`; the poller retries every 60 seconds
and sends one Matrix alert after 3 consecutive failures.
The deploy used to have TWO build environments — this repo's `.venv-docs` and ## Build environment
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:
- **ONE venv.** Every trigger — the poller, the (dormant) webhook receiver, a `publishing/requirements.in` pins every package the build needs (`mkdocs`,
manual `publishing/build.sh`, CI — builds with the canonical checkout's `mkdocs-material`, `mkdocs-redirects`); `publishing/requirements.txt` is the
venv: `~/repos/docs/.venv-docs`. The poller's private venv was deleted. generated hash-locked lockfile. `build.sh` verifies the build venv against
- **The dedicated checkout stays, by design.** The poller still builds from `requirements.in` before every build, installs from the lockfile with
`/home/ubuntu/.docs-publisher`, its own clean clone: uncommitted edits in a `--require-hashes`, and fails loudly if `mkdocs.yml` configures a plugin that
working clone must never block a deploy or leak into the published site. `requirements.in` does not pin.
- **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.
Files: `~/.docs-deploy.state` (last deployed commit), `~/.docs-deploy.lock` Regenerate the lockfile after editing pins:
(deploy lock), `~/.docs-deploy.failcount`, `~/.docs-deploy.alert`,
`~/.docs-deploy.last-alert`. Manual deploys should respect the lock: ```
`flock -n ~/.docs-deploy.lock bash publishing/build.sh && flock -n pip-compile --generate-hashes --strip-extras \
~/.docs-deploy.lock bash publishing/deploy.sh`. --output-file publishing/requirements.txt publishing/requirements.in
```
The deployed poller keeps one build venv at
`/var/lib/docs-publisher/repo/.venv-docs`, owned by `docsbuild`. A manual
`publishing/build.sh` uses `.venv-docs` in whatever checkout you run it from;
that is fine for local previews and does not affect deploys.
+14 -11
View File
@@ -2,9 +2,10 @@
# Build the member-readable documentation site from this repository. # 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.txt and # 1. checks the build venv against publishing/requirements.in 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); # current — no network, a few `pip show` calls); installs from the
# hash-locked publishing/requirements.txt with --require-hashes);
# 2. checks that every plugin mkdocs.yml configures is pinned in # 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),
@@ -27,8 +28,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 toolchain and run MkDocs directly: # In CI (Woodpecker), install the hash-locked toolchain and run MkDocs directly:
# pip install -r publishing/requirements.txt && mkdocs build --strict # pip install --require-hashes -r publishing/requirements.txt && mkdocs build --strict
set -euo pipefail set -euo pipefail
@@ -41,7 +42,8 @@ if [ "${1:-}" = "--check-only" ]; then
shift shift
fi fi
VENV="${1:-$REPO_DIR/.venv-docs}" VENV="${1:-$REPO_DIR/.venv-docs}"
REQUIREMENTS="$REPO_DIR/publishing/requirements.txt" REQUIREMENTS_IN="$REPO_DIR/publishing/requirements.in"
REQUIREMENTS_LOCK="$REPO_DIR/publishing/requirements.txt"
# --- gate 1: pinned toolchain ---------------------------------------------- # --- gate 1: pinned toolchain ----------------------------------------------
# Compare the venv against the pinned requirements; install anything missing # Compare the venv against the pinned requirements; install anything missing
@@ -60,10 +62,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" done < "$REQUIREMENTS_IN"
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 -r "$REQUIREMENTS" || { "$VENV/bin/pip" install --require-hashes -r "$REQUIREMENTS_LOCK" || {
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
} }
@@ -116,20 +118,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" done < "$REQUIREMENTS_IN"
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.txt." >&2 echo "FATAL: plugin '$plug' is configured in mkdocs.yml but NOT pinned in publishing/requirements.in." >&2
echo " Add '<package>==<version>' there (usually mkdocs-$plug) so every build environment" >&2 echo " 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.txt" echo "plugin check OK: configured plugin(s) $(echo "$names" | tr '\n' ' ') covered by requirements.in"
return 0 return 0
} }
@@ -142,7 +144,7 @@ check_toolchain
check_plugins check_plugins
if [ "$CHECK_ONLY" = 1 ]; then if [ "$CHECK_ONLY" = 1 ]; then
echo "check OK: $VENV satisfies publishing/requirements.txt and every configured plugin" echo "check OK: $VENV satisfies publishing/requirements.in and every configured plugin"
exit 0 exit 0
fi fi
@@ -164,6 +166,7 @@ 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/.
+23 -22
View File
@@ -1,41 +1,42 @@
# 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. Works with the agent # any change to main.
# host's current firewall (outbound only).
# #
# docs-deploy-webhook.service INSTALLED, INACTIVE UNTIL THE PORT IS OPEN. # docs-deploy-webhook.service INSTALLED, INACTIVE. It predates the
# Instant push -> deploy once the Infomaniak # build/publish split, loads the agent's env
# panel allows inbound TCP to the agent host # file, and runs repo scripts with the Cloudron
# (the Gitea webhook is already registered). # token. Do not enable it until it is ported to
# the same split.
# #
# Install: # Install:
# sudo cp publishing/docs-deploy-poll.service /etc/systemd/system/ # sudo install -o root -g root -m 0644 publishing/docs-deploy-poll.service \
# /etc/systemd/system/docs-deploy-poll.service
# sudo systemctl daemon-reload # sudo systemctl daemon-reload
# sudo systemctl enable --now docs-deploy-poll # sudo systemctl enable --now docs-deploy-poll
# #
# poll-watcher.sh itself needs NO manual copy: the service runs the copy in # The unit runs a HOST-OWNED script, /usr/local/sbin/docs-poll, which is not
# the dedicated checkout (/home/ubuntu/.docs-publisher), which git pull keeps # copied from this repository. That script:
# at main on every deploy, and the watcher re-execs itself when a deploy # * builds as the unprivileged `docsbuild` user from its own checkout at
# changed it. # /var/lib/docs-publisher/repo (a scrubbed environment, no read access to
# /home/ubuntu, so repo code cannot see any co-op credential);
# * publishes with /usr/local/sbin/docs-publish, a root-owned script that
# runs no repository code and reads the Cloudron token from
# /etc/docs-deploy.env (root-only, mode 0600).
# #
# ONE BUILD ENVIRONMENT: the poller builds from its own dedicated checkout # Repo code (build.sh, hooks.py) therefore never executes with a credential.
# (uncommitted edits in a working clone must never block or leak into a # See publishing/README.md.
# 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 and deploy to Surfer Description=Inference docs: poll Gitea main, build unprivileged, publish without repo code
After=network-online.target After=network-online.target
Wants=network-online.target Wants=network-online.target
[Service] [Service]
User=ubuntu User=root
WorkingDirectory=/home/ubuntu/.docs-publisher Environment=DOCS_REPO_DIR=/var/lib/docs-publisher/repo
Environment=DOCS_REPO_DIR=/home/ubuntu/.docs-publisher Environment=DOCS_DEPLOY_LOG=/var/log/docs-deploy.log
Environment=DOCS_CANONICAL_DIR=/home/ubuntu/repos/docs ExecStart=/usr/local/sbin/docs-poll
ExecStart=/bin/bash /home/ubuntu/.docs-publisher/publishing/poll-watcher.sh
Restart=on-failure Restart=on-failure
RestartSec=10 RestartSec=10
+13
View File
@@ -0,0 +1,13 @@
# Pinned build toolchain for the documentation site.
#
# Human-edited pins live here; publishing/requirements.txt is the generated
# hash-locked lockfile (pip-compile --generate-hashes). build.sh checks this
# file for missing/off-version packages, then installs the lockfile with
# --require-hashes so every build uses the same bytes.
#
# Regenerate after editing:
# pip-compile --generate-hashes --strip-extras \
# --output-file publishing/requirements.txt publishing/requirements.in
mkdocs==1.6.1
mkdocs-material==9.8.0
mkdocs-redirects==1.2.3
+599 -14
View File
@@ -1,16 +1,601 @@
# Pinned build toolchain for the documentation site.
# #
# EVERY package the build needs must be pinned here — this is not decoration: # This file is autogenerated by pip-compile with Python 3.14
# on 2026-11-12 mkdocs-redirects was missing from the auto-deployer's venv and # by the following command:
# 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.
# #
# Reproducible cold build: # pip-compile --generate-hashes --output-file=req.lock --strip-extras req.in
# python3 -m venv .venv-docs \ #
# && .venv-docs/bin/pip install -r publishing/requirements.txt babel==2.18.0 \
mkdocs==1.6.1 --hash=sha256:b80b99a14bd085fcacfa15c9165f651fbb3406e66cc603abf11c5750937c992d \
mkdocs-material==9.8.0 --hash=sha256:e2b422b277c2b9a9630c1d7903c2a00d0830c409c59ac8cae9081c92f1aeba35
mkdocs-redirects==1.2.3 # via mkdocs-material
backrefs==8.3 \
--hash=sha256:2722cbb6884ecadce4cab992113fa50fc2c28733949104132fcf89dba0ac3290 \
--hash=sha256:3930982530dc3e6c3b45094fdaa246edd59e4e91fd6b2dba61ee821efe1e3101 \
--hash=sha256:3f4b574b32f08b0c0dedc6ad15c3865ce93f1dca4fb31760e061bc4bac41ff2b \
--hash=sha256:bc7ab9f1f5444d23ce15795700f6a3e621f13d521e0cb87e21204ff1e12b8c5f \
--hash=sha256:bc87b4350f11cc6bf31a2f793dd2f9df577f5c91efaa943627bd261df26506aa \
--hash=sha256:be0de6f9ead4d44839169774643f25e36f4f2b05f7f1850368f5b5147e279e82 \
--hash=sha256:f9e7cc5934a9dd89bf1d86a91853120fca7cd32d7861c829c7a449f30100ba99
# via mkdocs-material
certifi==2026.10.23 \
--hash=sha256:a9895e6e2758b371e0545e321a3a8fd1fcfd9829ada8824a936dfb16aaaf36cd \
--hash=sha256:e9b54de76e530bb6cf0ccd036787103acb58fd42ba930ea8bf948ddbaa2f61d1
# via requests
charset-normalizer==3.5.2 \
--hash=sha256:01077390b03f7988f11d700a2194e69b119741a86b1a638b1db88891e3eced8e \
--hash=sha256:01b0c0d2262a9e28e8484a278c7e1b5d650e3ac8cf2683d2967e25899f208bdf \
--hash=sha256:04851f73ae72b8413dddadb16a49dfee95263553741fd42d546f7d66907e6be5 \
--hash=sha256:0521c5665880b33d603717defa76c094048900010897909952397feb3039da56 \
--hash=sha256:0774bf9bf620249fee3e0b8b9fd3065de213be30f3aa94ce2494b3b638949e26 \
--hash=sha256:0891b9d3903c5571c03771ca669a4b0ec5618ca722a5c957d3d29cd4e5062848 \
--hash=sha256:0c951d5e6dd9c2ff60609476752bee49da4206adde960ebc247766937f72e718 \
--hash=sha256:0fed1d06615f022ee3b13caf5e8b180cfea32bb2c5aded8a9d44277afc040f93 \
--hash=sha256:114e4d0c92d618409ed82a99e22b5c5e768fe995f2973f78265f4524f49d4640 \
--hash=sha256:11912e4bb14baae7c5d8791aa55ba0a3a03ec6729073307b0f57270abaa713d3 \
--hash=sha256:11a4d68a6ecda3292cb1e50239e111543ba5d709bb62a6b4ea1afcfa729d8875 \
--hash=sha256:124fbf1a8ff966d87ae05bb8bd45a71f966055ed8bba320d0c7cf450bc5f4d0e \
--hash=sha256:1461ac396c4fdb983a675f20aa555624f0ee18ac83d832b9244ffff3d8055275 \
--hash=sha256:1503bccbeb36d5527790c3930327704c39af22de3112f1b1666a9f3ce15ee204 \
--hash=sha256:15bb4005af6320d259dc7593ca84a38d7fe06a421dbcf7b910ae23979101e787 \
--hash=sha256:15c44f7edfd477b06f517a5cc317fc1707edb9de2c865f43d4b6513907473234 \
--hash=sha256:16fa0eccf81304b79c5cd87f9271c3b85dd9dd99245e4422ae9c0dd45e0f99d3 \
--hash=sha256:183b88127acdb4fabe59d951ab424faf1af7b63cdbb5f776186c1ea2ffcaed98 \
--hash=sha256:195c26fb65950f8fce54e26349852b7bdd7c5f120aeefbcc440b8a20faaed4a3 \
--hash=sha256:1afb975bd5d68d5ce9f6b6d44fdf2f7e34b895a35e95708a7a91b20a3b51d187 \
--hash=sha256:1b4cbc7c3491ccb4aa17fcd8165649d01cf39f76de1696da8631b5f71b85401d \
--hash=sha256:1bc0baf5ef96b6ede57d47f4b8fe4d9d84019c3bfcbeb20a41edc6a6ee341f1f \
--hash=sha256:1c50fe28bbc2ced33386f298650d91218076c05420e6cbd790b913adc41659e7 \
--hash=sha256:1db38f4c5496827c1a501846d64d14c3b80c7e6714e406cd7dc36a9899fa1011 \
--hash=sha256:211d5a3eb6af8f513b8d4ca19a8c1b7accab1b5f0d3175f9826b03c1a920dc1f \
--hash=sha256:23851fb4e1b85ed3f6c2a27b777cdfe2e19fb5b38429a8faf38c7542b7665869 \
--hash=sha256:254eb48b9fa5ee9898a3c445825a1f340fe53712a098904b39b0bddba8ea3cb1 \
--hash=sha256:2625388c6c754520c37abaf3b41eb34d1cc4a373f457898f08606c8e362b891d \
--hash=sha256:281cb91036248400f4cc957495cccd44c275c2e0c5854f7e45ac5cf7dc193847 \
--hash=sha256:28a15fdad492a99b6eccfaaed66ef3f74050680545ea61ec8b2f4c538f1f1320 \
--hash=sha256:28b4f0d66fb834ff90f28209ac7bce77868c45d8c93e26f906709d9b7c2e1af9 \
--hash=sha256:2a925889534b3748302dae5dead07cc13480de1dac3aea80a941b729b471ef93 \
--hash=sha256:2b7b3bbfb4fe8ef40600792d762fbaa9057559f9d3fad209525b7a22b99e91fd \
--hash=sha256:2c9ad19a6cfcd5ea5c0d41161d22f9df1dcc277e9bef2751391334546a314c00 \
--hash=sha256:2cc961b171b3f3440f410489ab3573e86aea8736134ebbb40ea1338b7f0831bc \
--hash=sha256:2ce45c6627b22c47e390bc91a41c3d13032192e699fa0bea96e9671b373d69b0 \
--hash=sha256:2e06a3a98f916dd41d27f3105e02e7a40181c98c94b9158733d03a6f80506c09 \
--hash=sha256:304d5463e65a35d7bb0850550e0780395395f6fcf452f04db7d5ca7cecc425ac \
--hash=sha256:304d8e4d493af723536393eee0c689eb7813f4a474c8b479dee63f1fdd98f621 \
--hash=sha256:30fcd120b732aa79317f08dee04d7de0847822e4cf7ee0e9f445bb958832252c \
--hash=sha256:31f3930700408d211f13378ccbe1c40845d8da54bd0681fac3a9b5aae81c7aa8 \
--hash=sha256:34276fd796040bf0993ab33a369aa572e6979c7aab225a88893667ad8eac8f7a \
--hash=sha256:355ad8011081dec5412240c087a9a0c9d4d5039f3ed11a3f13e18c2b29b56c51 \
--hash=sha256:38a873987f3be698494da8b2e3085e29da02da7b633dce73e79c699a113d7bf0 \
--hash=sha256:39de2a259fc954455c57274dc94c79d5842774e1247a016aff30bc0efed0f4ef \
--hash=sha256:3d14b50de6bf4d0edf857a9386836846f982b8f524e188e2e68b96d702bcf4aa \
--hash=sha256:3d21b8b13c7592db2ac5e544a6d83187b995257472b0c9e8351b6d507ae37ed6 \
--hash=sha256:3d31298449090ab8d47b7b1b2a555ff73cac7ed438a08b7ac160980c7ebed649 \
--hash=sha256:3ddacd27458c45bdacd6bd6db644bfb730efbf9e830310186e3045c9c5be8fb2 \
--hash=sha256:3df041de8887954562c9b261cba85ca0e9ded74048daf125f45edcfaa4832229 \
--hash=sha256:40ab6bffa02ae10a0581e6c198be7d2d8ca5c2a0c64e4ed3465d766df457573e \
--hash=sha256:4275811936e2f06feff5e598fb42a1b7ae852da8e39605211892b56b81a34efd \
--hash=sha256:443eae2bf318abeaf6f15d785138f71fd6de770e99a92158b8b814265e079115 \
--hash=sha256:447441e76ec720b15e64418d32e092297340387053047c7c694f579efb0ee1d9 \
--hash=sha256:4495c5002a7b28557e7e222e77e0b661183e432b7d6d2e788101e3f240e05b8c \
--hash=sha256:44bd4fbb29dfbeba60e7d2bd000c59e4b21ddb3cc53912b14048d37092706d7c \
--hash=sha256:4685902cf26edf013ed7a3da0f426ebba7a00ebb9541386d835afbf002c11cab \
--hash=sha256:498dc3188ca05a68231ac3fdbfc7f57eb67e1343c30e0fea17f8218c1599b253 \
--hash=sha256:4c2b5031f63e331e3839b40aed2dd6f191e9c07edbde303e7876846ea1946995 \
--hash=sha256:4d48f2d08b9de5864e2c8744d4461b862fb149a18274abc8b698c45975573438 \
--hash=sha256:4f87960d57feabfb618e4e0af6e7371645fa26a277860739d6e5d6e0012c92f0 \
--hash=sha256:50e3adfb96fc189eb27b1cf62d3b598b89b4bb0420d93a3d3e42e137409011be \
--hash=sha256:51cf45226a9b588d0d2b4880c62d686934b63ab0bd79ca23ab0e9762eb27441b \
--hash=sha256:52aa6992700996af31f375de0c6bacd402b0097fe40b53c426b9f51a90ebabc7 \
--hash=sha256:55ea99acb17b9325618de155a0cd6a2e8f5d10be008113e1d433bbb58db543b2 \
--hash=sha256:56bc200a365efb37383b7852e4cc5898d3b2da5987289b543956cf8cad71018a \
--hash=sha256:588461c2e8384d309bd63e5826019b6977bc66d629b99ac8737bb795d7b2cb5a \
--hash=sha256:58ca3755ee7ff7f59b57789ec9833c9de9ea275405cdd240eda1f193112e398a \
--hash=sha256:58f361dcbab699cf8f42db3f47c8e7fd1036f138c23a5d08de9fde5f425a730c \
--hash=sha256:598a11a2c7ebaa5334bf698bf29568c9c390abac6a154d8170fedecd1cea38c5 \
--hash=sha256:59f63901b0031c3136cf64704dcb21de0bbae62ce2c9529bc39d27665463de37 \
--hash=sha256:5cde776b7cc66e4f6c99612cea4aa7269aa65863f7a15841b2c264f103822f4e \
--hash=sha256:5e2b6b57e9733d39f0c9fd3185efa6b8e29652c4cd8fe94180272cf6ed9a78c4 \
--hash=sha256:5fb29fb8cd1a46c27a1bf9613ad5ec2599310d46b4025d9556404a6b6a292800 \
--hash=sha256:6045373d5a89a5ec71afde535db987ca28e76dfa276c2d4c818265b375d4b055 \
--hash=sha256:619799369eeef6366ed3e8755a5670f4f2f0fb6b30a0fd7264dc0fdc2357058e \
--hash=sha256:62588a277bfb59def052abd940703fa35107152bf479781a878617d60faf8fb5 \
--hash=sha256:62603db9a7caa0802eaa28c1c46fecd7b3a263a774069c24c3c28c302448721c \
--hash=sha256:65cd72beeeca9d3aaea1201e5923859f308f952f9c71de93f06063c79f0f7a3b \
--hash=sha256:68eb192d85ab8e5f6ec69c2bc6ac0179fbf04a5ac1569d12fbef74883fe102d0 \
--hash=sha256:6bd128f206a7752ae1f2ab6c61bf8a24ba28913a10df8b14c2637b973ff97a80 \
--hash=sha256:6be488a102b8cf28d0391d8c4ba7748938ae28b78ad901f8585520fca33ead1a \
--hash=sha256:7218e8f32b0956cfcd048fd42d9d5779809745ca1d86113ca56f66e7ae1549c4 \
--hash=sha256:7441d755b7ab94f8d4eb3e43ec05482d760842fd263d003a99102d742cd835e2 \
--hash=sha256:749e97e1b32313717a565abbe321bc2190bc8b35f1a67e4cdbc7c56c8d8ffe58 \
--hash=sha256:75a3ceed0724d625d64b86ca20aba182e4df462e04c2414fc941c0f523f06aac \
--hash=sha256:780fbe7cab297b81dad9fb8dc5eb003c0468ffb0d9e5f65068c53a34661a96bc \
--hash=sha256:78456a747de8dc58360ffa581f30a002baf5aa28cb262536545e91f113ed7639 \
--hash=sha256:7967d08cf06dee78443b874f98c98036f624f3a4e73e11f9f64f5be4d25393cf \
--hash=sha256:7a881931aa470808df94a8c380eed2bbbc76cd9dc622310f99665658c821eb6d \
--hash=sha256:7dcd882da75ef9adf94903b1e3b9419e8aa8fb4c7396822b834b9ef7fb96954f \
--hash=sha256:7e841fb9010836c992c9f12fcbd43a831de93a5f726fc1ccd8ca1d0268c5014c \
--hash=sha256:7fdde2c9fd9e3eca40631e024664cf2584272cc8f96308cbe5fdfc930f51d8bc \
--hash=sha256:8024d00c3faf3fc0c16e07a69f4405e8eac7cc0ab15f65fe6cf43827c4cf72b4 \
--hash=sha256:80d02b6f04e92601a081dd97b23d3128033098bff5d35d392ddcc0476ea11253 \
--hash=sha256:838dcc90063569a0448120554591a1d6c4a4ffe11babf048908793154ab86ade \
--hash=sha256:849df64e889b2e17230d58410a03dba311a65b163508fd33679b2b737d4b7858 \
--hash=sha256:87475fabc8d9996fd9c27debb395e642e8c838d78a00b6e932227a0e06b81e26 \
--hash=sha256:87e50a3e7cb90af586b6c5faf23e302a970415ac73bd7bd90a515a04b427ef96 \
--hash=sha256:89b53f3cda69831909888e0494f4fa0bcd3537e3e138dabeb620bd6ad946bae8 \
--hash=sha256:8a893cc101149f80a653f82062ebc95b34525a2614382e1da5458fe7c6997249 \
--hash=sha256:8b2bfab86aa71ae13aa41a6a26aab338e0db2b8bc75434b05aea89e011ff35a4 \
--hash=sha256:8d86d6fc60743dc916eb79e2eb1ec4818e21e427731543af40a3021851174a13 \
--hash=sha256:915563965d418f986e7e145accc592eae9e1a1be3566ff98a05d7a9ec42a76e1 \
--hash=sha256:92888bb3187c5ba50500b00b3b310c9f2c651709d28036077680cb5255450a03 \
--hash=sha256:93223adc95033dd47133a46ccfc316a0139176fd79085762e27202ec56018f03 \
--hash=sha256:9373ad13ef0d2c0fb761e04e55bfdee5a08b52cef2c882c8fbe9935b1517152e \
--hash=sha256:9409a8bf35cf78353942504b24a57de3d75b708997a1e4bd8db71ac8633ce364 \
--hash=sha256:9b7f416ff0978e2f2249330527f0ad6fa02f4932e6199692d3b52da2048c19e4 \
--hash=sha256:9bde855991b7e362c146535e3136a50bfaffc0487d38b33ca7e5edefc6e23849 \
--hash=sha256:9cae88599c7219005d879f98e5ed53341e9a122af585e1091200358a3003d2a0 \
--hash=sha256:9cf9b1a857e25c4baceeb3624e92a56df3668f398c4acba74e174d81fb4d1d3a \
--hash=sha256:9f56f72050826f63dcee7a7f55b0a77168cb3bfc553fd405e7f8f9ece75a4036 \
--hash=sha256:a090bb2c68df85450502e3e20d665e3a5af9c65a84d6508ed477badd49166fd3 \
--hash=sha256:a192e2c40070d92c3ccf777e3a5c4ff515573cd2bb7ed0c537fdadbbec5bbf21 \
--hash=sha256:a19a731138fc27d5682277d3b9df22855cea1239bce7fcec5f78f42ef2d1f3c3 \
--hash=sha256:a66c3bc5ab1f0ff2164fc9965ddd611ff0802173f4b9d24554c563f6ab7e1d6e \
--hash=sha256:a815775b6c38d4e0ff7bcffbeba67feded90202bb6a226b8dd35f1c855217413 \
--hash=sha256:a89012d6d5476ee112d20d998570ed58df2260a852afb1758809cd6900411d21 \
--hash=sha256:ae4f5fea5b8b8ccff88238cc8569303e5ee95efae67fa62922a311397a71f346 \
--hash=sha256:b6856554c4f44d79fc2307d5768854310a8f0096e501c75637542c82292b0429 \
--hash=sha256:b6b751274acb69d77b3323d6b7dbaa3c7fdfc1eb829b7eb61d262f32e1af9685 \
--hash=sha256:b736353c0a625bbd5fcec108576e2385db3496f4f771f785ff32e108d3c3bc45 \
--hash=sha256:b7fd005a73d9e657273b7a10dc71a9e03c8fb9ee6999798d6918ce095b81ac7f \
--hash=sha256:b91363207bd9dc966a691e959bb47f64b30f7ac4b072be9968b366982f7db77c \
--hash=sha256:ba0b1d2620edf869789c3879223f52bf2afc5d31b3cb47cc57b3a12c05e2aa9d \
--hash=sha256:bbbfc8e28816f19d7c0f1816664980c0a9875d01b27cdf8eedddb639d9e108ad \
--hash=sha256:bd16aabe4a02a297c23417aa17ac6299dbd8c49f673bcd645b4929b11f5a4400 \
--hash=sha256:c0afc6800ba57ccc350374c5bd6150419915d95ce93cdbab2d783d75eaf30ecb \
--hash=sha256:c6708715abcf3c73b99508253e961a9967f02fe536532834149574eda6de0d1c \
--hash=sha256:c7c9ab723cde841fefb34efbad91e87f00a674b1fe1cd0784fde742bf2c154dc \
--hash=sha256:c8f3d67aeaf55f017982b73683f0e7342ba2f6635a78f69ce89ebb26aa411e5c \
--hash=sha256:c9790464842f85f437dbbb54417eda1e0e6bfc52dd8d22d6fd1c994b73b2dc74 \
--hash=sha256:ca403d7e4798f525fdfc78e258820419cbbd0f0ecbab9de7840e3c017cf6b8cf \
--hash=sha256:d008d90a7f2471519aef0c90dfbe73b3e6e4d5e66ac48e19154c17e89e98b604 \
--hash=sha256:d19fbd981a488e22cd04883659ca6b08f50b5974f9fd7c95655ef6a043e5893f \
--hash=sha256:d1befeed746d247c81127bb14de9dc3d30edb6e5976d34f83f86ed262b1d9105 \
--hash=sha256:d2374b62878abb00cd8309b32af6c0b715cd02dec0ca74ef12e5069bdc64144a \
--hash=sha256:d376bbd28b3a8999db1a103b3b388aee6f1ddeb3e51bc2172993efdcd86e064d \
--hash=sha256:d4a7319f304a774bed22115bc891618e45f85065ab44ea6acd07d274e750519a \
--hash=sha256:d6734d2ef8a50fbf8445c139477da401f50d62a0606bf00e20ec6d87773fefb1 \
--hash=sha256:d760fe2a4d7c3b226cb9026d6a842868d52a7901bd98420e1baf14e80da85cf5 \
--hash=sha256:d913de495d90407cd859d263bee2e5d1a4ed3eb6573c04e70d9ec619a7cbed7f \
--hash=sha256:db19d07e2e0129e974a0e65d0064fc222a446cd5122c2fd4184d2af9fc734a9e \
--hash=sha256:dca9ab98072a5a54ebacebdc45f53e645336b320c667410b061be1ca588ae709 \
--hash=sha256:ddc7dacc8ece3a182e7f15cb862d1fd616b46d076cb1ae9dd232b2c38b655874 \
--hash=sha256:ddf19c062bea7a0cc80f519243d2c01dd091be0cf952a0750d4ad576709559f5 \
--hash=sha256:def79fa35ef0cef8d2accec024f4fdc7ead3012ff02f5215c783f39f03ef8cfc \
--hash=sha256:df29a0a7107f7011e77f4eebdddec4c7331e24d787a0b21a46d63bdf7445da95 \
--hash=sha256:e09a3942ecbdee5cce73ea9d42da82b81b72ac1bf031ce069b93b5adf4eac8cd \
--hash=sha256:e242bb1c5e76e97dfa9e7f209a71e93a01d7f19ffdd5cfbb2e2d55b4f08f8ab0 \
--hash=sha256:e243bd13217235fc7290c621941c3f5cc8b66e4872495be821d7436ba2fb838d \
--hash=sha256:e2af3aad578aa6bd1384bcf4750fc285e5a9de53f40b7d41e5a0bf748edeb2b3 \
--hash=sha256:e4e81e09c1578b8df602e3db08b0b3ea0a6947ad612f52bf8dc5ea8d47691f0c \
--hash=sha256:e54da4baf05720032d527874d40b65fa4d7e5c6c6a43d0c3adbeffcaf275a2b3 \
--hash=sha256:e80e6c2f55656b4824d72065abb4ddd6a525c74bd78a0aab5d9fc2cf4fb5af50 \
--hash=sha256:ed2a239c0ea213acc1908150a3037257083c7c083128f1a4cec2ec4b97dca491 \
--hash=sha256:ed905975ab14056a2e5eb1c376cb2e1ebc5396baf84163939c518556fccde9f5 \
--hash=sha256:ee21e28f0430bd6dc9086c6e525d5e818a44a5ad19720c8a0ef766792f3eb5e5 \
--hash=sha256:ee43c17b173d46a3212baa6ead3ae258eeabdae48c263a01ccf0218c366dd655 \
--hash=sha256:ef4fcbf3327382cd4c9f540babd61248208af7b93eec4de397b4d5f58a09e288 \
--hash=sha256:eff0ac9dbe711a4aee69bf04a83896aa9b85f19641264053a9f6d48573abb7dd \
--hash=sha256:f0aa869112ef88429ae17820d99c3dd9504c9e9c671d3c246f3d7442cb051084 \
--hash=sha256:f3c96f633825733f735c5a9cf21d21a257d8e1edf0b1cee0a064b9c424ca0f7d \
--hash=sha256:f5833ad231be5eb6553de524a70f48d71b2c8563101750531e0b80184e175cd4 \
--hash=sha256:f5ec61164adcec446f8969a3358ec3f9b26bbda3b9213e5586d219afa8df2915 \
--hash=sha256:f7d486c83842422badd511868fd8a9a20e9407ace71564b6af47ce7e60a336c1 \
--hash=sha256:fb9e68df06293761f9fe66ade60a9bc6d0f5e42b8acf2939a9158af86ab0e5bd \
--hash=sha256:fc14a032f813bf5fe624d991960ea83e9715adc27e4c1830a2361eb1d02ac341 \
--hash=sha256:fcff63213e8e6e47770541a4607175404f47cbb3ebea7b6058cc82d524a0e424 \
--hash=sha256:fd1fbe0f116b6e55da77aca2c6ddcddcfac2186cbf78bdebf40fc156efca389d \
--hash=sha256:fe9753dfee015c570d73df76f899f18444d41388bffcde097deba51c4fadbb9f
# via requests
click==8.5.1 \
--hash=sha256:8bb5376d2006950386f8c6427613334a2acadc5f559cb80e638d00b4df957e37 \
--hash=sha256:9bbfada76703fd1d784b83eea012e3e8c6a001a876543ef104fa56aaaeb072b4
# via
# mkdocs
# properdocs
colorama==0.4.6 \
--hash=sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44 \
--hash=sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6
# via mkdocs-material
ghp-import==2.1.0 \
--hash=sha256:8337dd7b50877f163d4c0289bc1f1c7f127550241988d568c1db512c4324a619 \
--hash=sha256:9c535c4c61193c2df8871222567d7fd7e5014d835f97dc7b7439069e2413d343
# via
# mkdocs
# properdocs
idna==3.20 \
--hash=sha256:a7db850025b95ded1eae8a46181a1a6c56c92c96f0e2b005d9ff8dc0210cab44 \
--hash=sha256:ab7ae7122974553370f0bdb919e1a960b2cd1bc1ef0276416d896db81c14582c
# via requests
jinja2==3.1.6 \
--hash=sha256:0137fb05990d35f1275a587e9aee6d56da821fc83491a0fb838183be43f66d6d \
--hash=sha256:85ece4451f492d0c13c5dd7c13a64681a86afae63a5f347908daf103ce6d2f67
# via
# mkdocs
# mkdocs-material
# properdocs
markdown==3.11.3 \
--hash=sha256:81eb91631dc97ad1efbc76019ef0f80fe90ca49ddf81546752d79989c3bfff3e \
--hash=sha256:e1a31a112232504d753e5c01bb8c2de90d3f0ba986b063e10770cf7695b09e73
# via
# mkdocs
# mkdocs-material
# properdocs
# pymdown-extensions
markupsafe==3.0.4 \
--hash=sha256:007e1ffd9bf65bb6ee96df7b258fc632a4868dd5566037986c64781f35a36e98 \
--hash=sha256:02fa4acbc6a3fc5c693c34d4dd8c1130b7fe99cc915181b0ddd6f72aeb296002 \
--hash=sha256:03470d1a8268e692ecf79ecd565593e59d44219377a7ead61f1f1b94c1f7ff6b \
--hash=sha256:04e7902ba80ee4bac1d50a549606527a1dcf0476cd81403db41099d3b60ec653 \
--hash=sha256:051417f74bcaaefa316276e0ff723f541616ca51043d070da00249d9bddd3e3c \
--hash=sha256:05295589e619b9bed252a86b532b8e27350abc372d18ba89b59375325e91ec1e \
--hash=sha256:06de8ef6331f6e822c28d577dc8bf43fe398800477c49498f38fc38b67ff33fc \
--hash=sha256:0764a13d34cae40db7bbf3a09b7e9b491bf4603e20b263a7a9d6b8e324975d0a \
--hash=sha256:077293e425f28ec737dbcad442a71752e28f8ae27cde3d68acd1fb212091cd92 \
--hash=sha256:0930db9bdc62d22944e10b066448bb65dc9abe9112880c7cab8da54db4284d5f \
--hash=sha256:0cee7cb0f9a1b6892ea482237d9403b3d1b4603aee057d0ff01f0fac2d019a97 \
--hash=sha256:0d9c47709875fdb321452056622e930c52afbc07a7d780762fbb8b4d91ce6fa4 \
--hash=sha256:11935df9bf455ed0c04eb87bcd720f02b1fe5e02128a9430f23aed6f93336fc7 \
--hash=sha256:12a606a492de952afcb43b59a14aaaaad120e708d3663dd0fdf2d738d427a691 \
--hash=sha256:14bd2d845d62ab678eaf81da89d7b621b51756c72346745c1a594c09d49207a2 \
--hash=sha256:15ba9e28640feef770374b116a6f019c21f52404aeabe516aa7f800587b98cfc \
--hash=sha256:18a801868a884f216e784d7d14db2a4077143ce7610440aee2ce8f734e7cfcde \
--hash=sha256:1c0df495a977d10460a94941799c72d5b5ab03d3858d949b55b5a66c8f371c99 \
--hash=sha256:1caa2fa5a6184fb233153b35f654e6687bd555476f6170f29d8ee9be1a8b0af9 \
--hash=sha256:1e1451fab512d1bcc3dc26988ec1edb0b82c2db909132872cd9356070a6b63df \
--hash=sha256:1f1f9477e174582b0a1b583d60b66e1f2cf5d3fe12cee985e4aedf44766600e5 \
--hash=sha256:2628d3a8cb648ecebb3c5d6b0a1052d400e4d8b7ac0fb786be8d285b50040d17 \
--hash=sha256:26e9867520db70d37f7fb421a7f0d8adb40171011fb84ce869afa1a83370dfa8 \
--hash=sha256:2a6ef68ae94aed8721934072b27a3b654ea2100b97e4ab864cf1489c90926fbc \
--hash=sha256:2b2b1e18af909b448bb3cf9e3433366f7a8726271fc214e8b10e0f62a78c724b \
--hash=sha256:2cb3dd71fc6be918ad4264346a8ed69485f9b7ed7bf35495d8e22807cd6b8bea \
--hash=sha256:2d1b7d9308288661f56672b1b157d75fc536714d3638487bbea17b6318a78248 \
--hash=sha256:2dad610540cb2e6272855c178f08ae9a1c7ac258a7fb71660553a5f104b42741 \
--hash=sha256:2e5a7cd7fdd14fcb1ae5d7d8bf23d24fbd1daefd1fbca2580132e1ea75f098b5 \
--hash=sha256:2e9ad7dd851bf45fab9f75cbff4cb493fee9979e8d8c7c9c3ee119022518edd6 \
--hash=sha256:340cbb1957ba99929cbf19a75626d36ba1ae21d1730b287d1cf7f824a20c4fc7 \
--hash=sha256:34bdde374c5932765d7dc685c4a1d191a3207852d67e8e0a9eb6ea85156181f1 \
--hash=sha256:353bd63081912ab8cfa6a0c7d185934cdf8426f04c618bba6bc4b394f2069b67 \
--hash=sha256:387d8cd30e69b3f0a72877b9ae717033396404e19095b17fe89753a981fda44f \
--hash=sha256:3882fb412298575bae3b9c46868251f15cc69307359f87bb1b382e53d6e5a2c9 \
--hash=sha256:38fc55594dab834470b6733dead2ee9e3f657fb0608c769dcafa0ba5ab52f45c \
--hash=sha256:396ec4e65cc889f69786b3b89478b471cee5a3bcf468b9d9bb03e1a30fb291fc \
--hash=sha256:39dbacefc411633db5b4378b066a9aca70a3d7e2922c9e578d825f844026eeba \
--hash=sha256:3a93d9616ddecfb393727a0041a562cf0b15a244e20f2bd25efc7949be4c4f17 \
--hash=sha256:3d23795802fc8bd72534836d64489bbf0f67c088959091bdb22e10735a5107bf \
--hash=sha256:434139499bb20b502ed3baa1f169e618f924a97e7a777fea1a49446d80106cf6 \
--hash=sha256:436e3ffc6310d3c41878c601db29098102fe5d8a467c49da4a4125254e0980f2 \
--hash=sha256:489505b03f692c3f376394e49194fa7a7f9e8558d6e293a7056a0032b0c38163 \
--hash=sha256:4a540e2d3192792fc84eced57bef37851ccb2b41f73291bb17408eea77bcd278 \
--hash=sha256:4a7cdc2a420ca01058182da4253329764d4bfa055564d1eced90e6ba1e8b1d3d \
--hash=sha256:4bced6e2a6dba6a28f7dd3c6ce14df1b2dd495923f16ea484cad03decd463b2b \
--hash=sha256:4cf3468d5ec187ffffcaca8e61929a37448f215dafc1386a12c750a72fe53634 \
--hash=sha256:4e2c4809c14559aa7ef426f27fb35afbb38104c349a903bf8f3600456764bb38 \
--hash=sha256:4ed644d75aa94a2baf7ec3a96eaa160ea58c742eb9d27c6506053c5c40fc84ed \
--hash=sha256:4f6e0852a0283b1b1fd776eeb7b766a5f440b3e2bd31ab51af3b400585f3965c \
--hash=sha256:5066b244f576f91afc8ee3ba029a89f99d39c79b1853fe9d39bea9f0afbec148 \
--hash=sha256:5086f9975abb1ab531ee6afca1761e4b59a19b446f3f6522ed776963228cfe5a \
--hash=sha256:50b5bedc9ed8a94fc8857a42ef4f84a81ea88f8d4f05dc8705fb23ee6d8dcca7 \
--hash=sha256:52704c5d36eb6dda8866493decd61111fff86244c9b1ad225ca01b9e91e5970f \
--hash=sha256:55ffd6ce583d97dc71dc92e930324c8c0d25aea7e3ade6ae54ef77cedb096811 \
--hash=sha256:569d65055d367e3dcdf30c3f41119467b73d9ee9faf332bdf40402644f5ac08e \
--hash=sha256:57f9947a7e57a081c1e3e0a2dd0d2dcf290a4531450e6f611e30084c222a7295 \
--hash=sha256:5989cb26b2e1efc6a42216a9f6b5ee495ce5ace2e5b352a9af489976b32d1ee2 \
--hash=sha256:5c22873ad1f0532ba40fa1727f3c0fc1bbbaab6d373d4cbe3f0dc74b2e2521c7 \
--hash=sha256:5e8b3d0b18fd623afa12ecb2ce8d8becef69f9b5440c6330c7972200e0bb84b0 \
--hash=sha256:61631e08084be9e21a8967ec3139c7616ed7c5e9368e05c86d1b39562c8a57b6 \
--hash=sha256:64511c54db4e4987aef4c41923235927428729e8174c5dba488429be70a998ed \
--hash=sha256:6669c1bf34080161ce49c589cc512ef24d4c704ac9d2b2d3667f519c60418378 \
--hash=sha256:672d207103e6b16ca098611b0f9efad6bc00afd47c03d6ef62186495ca677dc0 \
--hash=sha256:6768d67d1bce64270e0fdc2e69309d68b9b18ae56ddf6c711d168e9d051c2cac \
--hash=sha256:6a45c3d514f2436064db00d7fc8778d888f0236ebfed649b53d13a59e69ad51b \
--hash=sha256:6bd9e1788e15bfcf6a9082de42e30387e7b85d211ab21e57a939bb8cfaaf8d96 \
--hash=sha256:6d2a9efe686f9de00d0d1ea32a4a5a86d558a2277501bd78d964214eab625e59 \
--hash=sha256:6da83a088f8ef93b2d483a8232a4dbf4d69d3d8496b568a03c56becac43e1808 \
--hash=sha256:7018d4af1cd272e847aa5917983ab5e83e4f6579f9dbfecd4a79c0ca80b144c2 \
--hash=sha256:71f88e749ea29f67f21f3b36433c1dc54c7729ed2a6d9e2da2e0d9e0d7b224eb \
--hash=sha256:737c9c3981998eba27f11786f84fddcbabc74068b72a4a1f454ea02094b57b65 \
--hash=sha256:73e77980c7207854f00fc4e71fb1626868d5740ab4012623d55c7a99ad122a72 \
--hash=sha256:799c39bdf5e2f1292fedd3009f7b3c9e760f10b2420cb9638d56920840ff6db8 \
--hash=sha256:7a83aa6e4805df46fed18e989d3d16f86ef60cb50bbc8d9ce3a6be89165fbf6e \
--hash=sha256:7d3391b2188d18737cb2fa147028b1096236eaa7e156446c650a489fa2cadc91 \
--hash=sha256:7e1636da3d8dfc220b6dd10264db5f2b165e4888c4518594898fbe381049af8a \
--hash=sha256:805c8b84534fa10891890f0e4be39f3a99e94615d93e8836bf9fa1fdca2feeb2 \
--hash=sha256:811d02d5122171c1941357efd8f9bf4ffe907b7f0a1a4e729a880e4be3f46e3e \
--hash=sha256:8138eb83940ec7299024d92d4dee45f601b9e6c5ffde9d25f4e35e326203c707 \
--hash=sha256:83b3944fea42a8400edf92fd1770fb8d0d4f7de651353bd2d8525a92dba69a21 \
--hash=sha256:849dd2bb0e5e4ab2b71c7191726a4a8d5aa8a610daa584728cbee0b710ddc4ef \
--hash=sha256:8698d70a8081ee8c090dbb394768b5789a1da8b131b5499f89d071dd3cfaf6be \
--hash=sha256:8781a792a070cf2bd1b86d3aa943894115faaba6e88122a7bf32d62072742453 \
--hash=sha256:88d59b473bfb03259722600839af9bbd7fa13a2eb514beefeedb95997882f69a \
--hash=sha256:8909c2f1c6dd65e054ac4b573a91c8384d1492281e55d82d159d653f7a13adf6 \
--hash=sha256:8965520ac587c94a4ac48b729be3d8b8de00af39699b17585dfb599babe77977 \
--hash=sha256:8b5d563170ff8ba3181caa967c99a3c804d1dedb702c7cb93a6a7c32247da978 \
--hash=sha256:8e124f974786f831d6043728e38296969d3579db8896fe004682f5758e613581 \
--hash=sha256:8f0fac8b13d14bb06c68195f849371924ae53dd7b1c00fed24650f704383b692 \
--hash=sha256:9240187afb63d2f9ddc3e032c670356fe941f6e20662ea168a5dc3f1f317e1b3 \
--hash=sha256:925f929d6b59a8b3f8b8c6ac363cd0af7eecc81efb3071770b3c6717c450a369 \
--hash=sha256:9348cbb300d224fe3b89793262cb093504d4ae927004468463f745188a193e4a \
--hash=sha256:9388003072b95f2f1e3fd908604194d653ba21330d811961a78b7da1a77e9e36 \
--hash=sha256:9438a2648b2195980cb2dd8e53ed7b8df91319e2d0b70ae61a9e1d1bc8d3bec9 \
--hash=sha256:94e4c421742086aeee4c32a506eec8859d7634aad943f7e6aacf70f813478768 \
--hash=sha256:94f5407f7bc64fa6463906b896f9904beeeb7dd8dc116ee8e9056c8714ff9916 \
--hash=sha256:971a3bbb75d97ae4e2e8f7d4834236f86f85f0c85e04ab2e191db1123b04f80b \
--hash=sha256:9e227f3dbe6bde7491cf0a9965d00b88c6b1a4a95d11480ddf88bb96d397c19f \
--hash=sha256:9e25feb9e330b63edb0278a0acdf85e50d0cb0fbf49c3084abbe4e24ae195346 \
--hash=sha256:9f098115c247e11d138ab83a28fa0323c77015007ea2df73ba5fd714dfefd67c \
--hash=sha256:a18f38cafc329bac5e3c2b96c765b4c96d3d103421ed22ab7988c1e3fce27464 \
--hash=sha256:a4bbd2d87dd233b9fc5812160c3d0ffbe42edc22a26ce0469f58479ede633fe9 \
--hash=sha256:a5fcffb37e602b0b3c1638a97746b9b96125caa9bcf6fa41d337a9261de231ee \
--hash=sha256:a8e9f292fcda89b324f2f5c91d13f1424a153e40fc2756f38ee23b15835ff300 \
--hash=sha256:a9f54054101545a9a9cccefddf54316aa6e4491611fcbef9e91b3b6bebec04f6 \
--hash=sha256:aa2c838cc024642cc04c6854232f32b43e5e22833dd11119c1766c7873b8370d \
--hash=sha256:ac0c7c9f1609b0c4c114feb1d7a3409564c7fb77e360bed9e97e5d25dfeaf868 \
--hash=sha256:add96447a86d205ab616665d53b2950ee81083757f56e6ea833c8b2917646b46 \
--hash=sha256:ae9dcb8fbe244cb82f8a6458b455b927a03685e383d9bacf1ea5ce180b96dc97 \
--hash=sha256:b4a635a0487774f841cb1fb62e907e7195cc95bc761e053184b8acc3ceb20733 \
--hash=sha256:b4d12837e0203bbace818ff4a7461afdcd78bcd782351cea148139180d7bcffe \
--hash=sha256:b61687d0828e72bf5cda24a2690188f37170bd31c9359ac97e4e66569f120a16 \
--hash=sha256:b807e598953730f82e4eae3bd30f6a122cf6b31c398c6b504c0e04c13c170429 \
--hash=sha256:b8cd1f918b26fd7b1832ece557cc18f2d8747309ff8b3f0ef9d4250c5ad67a39 \
--hash=sha256:b91cc9d336957239ff200f30097e6fea2dc6d6fb3c81e853eaa09eac904fd894 \
--hash=sha256:bd3ce56ae2cbae3ba82b683bc425cd7e48d2ed8b10f3e818186b6f5646d9271c \
--hash=sha256:be6cb0c799abb0e2ba3e618e6d28ddddf7e485f6c2ce938dfa237daf3905072c \
--hash=sha256:befb4158af32106b9a93db8d6d1d1cbbd418c0d5aca0cabb7b1780abf0c89169 \
--hash=sha256:bf053da3c97a4bc5ecfbb218cdd2983febd91c617be8367d139882aa11e490aa \
--hash=sha256:c02e8f18bdedba082cef725942ac823b9b60656db07f7e265cb31618dfd00d77 \
--hash=sha256:c1bc67752d5f21013cfe430df4062441714eab79f65a6a05e01505957e9c35fe \
--hash=sha256:c61750fadcd119d0825bcb7d7d675dd264dcc89cc05292aab5be68ebdbb374ad \
--hash=sha256:c90d5b3d4e944e065a301d741b3c1d784f6bd1f503aa68b4967e32b2ba313d85 \
--hash=sha256:c9a7f43c0b202b334cc9184af09bb8f21d3a209e038efaf106936fb69e6b026e \
--hash=sha256:cb96e6e088d6cf71c1ea977510948320234824cf226e32f6f6e044f7a9c82b34 \
--hash=sha256:cf63c214fe879a65e69a386f915e36104fc84254ab141240f8854602d8e0be2a \
--hash=sha256:d1aca03ede943eb80ab3d63bb082c84b7aab85ea83bd0fd0c200260945fb49d9 \
--hash=sha256:d2e56fd3b00222722abfb3f5f0759ddbae4b90811b5ad4343c64030ad1bde70c \
--hash=sha256:d5f93ebbeb8032d47e349328ec8662d973d9b05a70b3c35df1f91fe419b84749 \
--hash=sha256:d882a373d8093c2941e01291b7ced96e9cbe4781da9a7751ca7e6c70385e5214 \
--hash=sha256:d920abdfa61279ba1a2ef9484aab07bf03331f8c08a10120fa332353d06e6932 \
--hash=sha256:da2af0d7aebfc2074080d72efa6ab8317c62481ef1f896f65d9999c1c01f4494 \
--hash=sha256:dd8ea6ebee7aedbf7c749fa80521d9ccf1ba473e0d1e14805caafbaad281c889 \
--hash=sha256:de8b364c423ef0a4bad9069657d617f9a5d2b2062457a89b1fa16ee199c399c1 \
--hash=sha256:df1ae86ff54725a01fa1a0510b914ca53a161b7050be74f6204e24aded5971d0 \
--hash=sha256:dff05cb7016dff1e9fd68f4122c127b65dfc59de5306cfb7ad92f956f230bee2 \
--hash=sha256:e1a622f13970d81f95d0c72f9dc090dce9085fccfa4c9f2174377ee32bd15786 \
--hash=sha256:e49fb0d1ce92cfa0cb198cc5b1b11cdf9d0638658e2a2db2687e39db7c87fc78 \
--hash=sha256:e5c802729725bd07e2bc3ab7b76dc7e0bbfc53129d8f1eb1c002c24cf774717e \
--hash=sha256:e841068dc0be4cb6dfb5c890eb88cbdcff2f4a332393c7ec94e8e618bd32c1a8 \
--hash=sha256:e916035e3e9930cbdfdd10abf48861340221857f45509565898e012263f7b289 \
--hash=sha256:eba154571c16e032112afac0dc2dfe9e63c2ceb7aedd07bb7eecf2ce26d4dd4c \
--hash=sha256:f03460ff076f70ab595bb45a0205ccea1971443575b6920c52e755dec2b3fbfe \
--hash=sha256:f0ec3b750b59375eab5b0fb2b9254810c00a3375be6d789899f1055a1d556237 \
--hash=sha256:f291bcf42ae98eb5107edb162c3c998b4a89648fd8e99ed4cbd12705292788cd \
--hash=sha256:f61efe1d2fe0de16158a5fe1d1cf3c14bdb6aecd54d8938fd26512c525c1f624 \
--hash=sha256:f68edfc67aabac33708941f26f22a7b8e9f81429bc0cf249fcf7d66b23af8d19 \
--hash=sha256:fa95848c929b6a75f6848d3c9793e59db365ee436776e57db835cdbfa79ba977 \
--hash=sha256:fd9f8797427910198f95bced71ddfed61130d7e349213bfb8466c9c99e2c46a8 \
--hash=sha256:fdb4ca07ab75ffadab4a8b135ad59cdbb3156b99310f3d565370da74a15d6bd3
# via
# jinja2
# mkdocs
# properdocs
mergedeep==1.3.4 \
--hash=sha256:0096d52e9dad9939c3d975a774666af186eda617e6ca84df4c94dec30004f2a8 \
--hash=sha256:70775750742b25c0d8f36c55aed03d24c3384d17c951b3175d898bd778ef0307
# via
# mkdocs
# mkdocs-get-deps
mkdocs==1.6.1 \
--hash=sha256:7b432f01d928c084353ab39c57282f29f92136665bdd6abf7c1ec8d822ef86f2 \
--hash=sha256:db91759624d1647f3f34aa0c3f327dd2601beae39a366d6e064c03468d35c20e
# via
# -r req.in
# mkdocs-material
# mkdocs-redirects
mkdocs-get-deps==0.2.2 \
--hash=sha256:8ee8d5f316cdbbb2834bc1df6e69c08fe769a83e040060de26d3c19fad3599a1 \
--hash=sha256:e7878cbeac04860b8b5e0ca31d3abad3df9411a75a32cde82f8e44b6c16ff650
# via mkdocs
mkdocs-material==9.8.0 \
--hash=sha256:19304a7263c5700428227122b3b2699aa73f432c9de8816876adaec7d7293ce3 \
--hash=sha256:1ed4c5edaf405a3fb62e55288b8fdff592971729361548b1ffa757bf9849fb81
# via -r req.in
mkdocs-material-extensions==1.3.1 \
--hash=sha256:10c9511cea88f568257f960358a467d12b970e1f7b2c0e5fb2bb48cab1928443 \
--hash=sha256:adff8b62700b25cb77b53358dad940f3ef973dd6db797907c49e3c2ef3ab4e31
# via mkdocs-material
mkdocs-redirects==1.2.3 \
--hash=sha256:5e980330999299729a2d6a125347d1af78023d68a23681a4de3053ce7dfe2e51 \
--hash=sha256:ec7312fff462d03ec16395d0c001006a418f8d0c21cdf2b47ff11cf839dc3ce0
# via -r req.in
packaging==26.3 \
--hash=sha256:94edc256424af38762eb31306eed28beb9f0efc50a8837492c9d6fd6004aed79 \
--hash=sha256:d7193f7c8e4e93f444fde0262bf90af30e16fa0ad0ad44cb553c87339b23cd1c
# via
# mkdocs
# properdocs
paginate==0.5.7 \
--hash=sha256:22bd083ab41e1a8b4f3690544afb2c60c25e5c9a63a30fa2f483f6c60c8e5945 \
--hash=sha256:b885e2af73abcf01d9559fd5216b57ef722f8c42affbb63942377668e35c7591
# via mkdocs-material
pathspec==1.1.1 \
--hash=sha256:17db5ecd524104a120e173814c90367a96a98d07c45b2e10c2f3919fff91bf5a \
--hash=sha256:a00ce642f577bf7f473932318056212bc4f8bfdf53128c78bbd5af0b9b20b189
# via
# mkdocs
# properdocs
platformdirs==4.14.7 \
--hash=sha256:391513b74707c42335fff3ea17eaac657a7ee9ffcadd809634d34ea594d0122c \
--hash=sha256:5472257c1cf97a14658af52997011c7e59e4aebf3a24950b973c11b579e1b074
# via
# mkdocs-get-deps
# properdocs
properdocs==1.6.7 \
--hash=sha256:6fa0cfa2e01bf338f684892c8a506cf70ea88ae7f3479c933b6fa20168101cbd \
--hash=sha256:adc7b16e562890af0e098a7e5b02e3a81c20894a87d6a28d345c9300de73c26e
# via mkdocs-redirects
pygments==2.21.0 \
--hash=sha256:2363c69b61c4a97c838da3b130dcd6468f4848992b21a82f2a63ec34377137d9 \
--hash=sha256:610ca751c9bc2492b38eb9a38a7fbc93edbbb2d7182edaf34e66ae493dee5c8c
# via mkdocs-material
pymdown-extensions==13.1 \
--hash=sha256:093d1fab98168526d98fbb17aa5c9da68eef3664324f6b25ebbf78b2709babeb \
--hash=sha256:e1ecec373677483b7324a47e5b4bf2e0c6614fe8dcdab1dcc6a05ecefd9b527d
# via mkdocs-material
python-dateutil==4.0.0 \
--hash=sha256:a5e246f79eb80475e691bf93862cead98decd8a498cf53ba0516fcdc0f50dc1c \
--hash=sha256:d7295ff14fdc0f92f662100bfb6c551d160ca090f2939f1ec5b9794265c03f06
# via ghp-import
pyyaml==6.0.3 \
--hash=sha256:00c4bdeba853cc34e7dd471f16b4114f4162dc03e6b7afcc2128711f0eca823c \
--hash=sha256:0150219816b6a1fa26fb4699fb7daa9caf09eb1999f3b70fb6e786805e80375a \
--hash=sha256:02893d100e99e03eda1c8fd5c441d8c60103fd175728e23e431db1b589cf5ab3 \
--hash=sha256:02ea2dfa234451bbb8772601d7b8e426c2bfa197136796224e50e35a78777956 \
--hash=sha256:0f29edc409a6392443abf94b9cf89ce99889a1dd5376d94316ae5145dfedd5d6 \
--hash=sha256:10892704fc220243f5305762e276552a0395f7beb4dbf9b14ec8fd43b57f126c \
--hash=sha256:16249ee61e95f858e83976573de0f5b2893b3677ba71c9dd36b9cf8be9ac6d65 \
--hash=sha256:1d37d57ad971609cf3c53ba6a7e365e40660e3be0e5175fa9f2365a379d6095a \
--hash=sha256:1ebe39cb5fc479422b83de611d14e2c0d3bb2a18bbcb01f229ab3cfbd8fee7a0 \
--hash=sha256:214ed4befebe12df36bcc8bc2b64b396ca31be9304b8f59e25c11cf94a4c033b \
--hash=sha256:2283a07e2c21a2aa78d9c4442724ec1eb15f5e42a723b99cb3d822d48f5f7ad1 \
--hash=sha256:22ba7cfcad58ef3ecddc7ed1db3409af68d023b7f940da23c6c2a1890976eda6 \
--hash=sha256:27c0abcb4a5dac13684a37f76e701e054692a9b2d3064b70f5e4eb54810553d7 \
--hash=sha256:28c8d926f98f432f88adc23edf2e6d4921ac26fb084b028c733d01868d19007e \
--hash=sha256:2e71d11abed7344e42a8849600193d15b6def118602c4c176f748e4583246007 \
--hash=sha256:34d5fcd24b8445fadc33f9cf348c1047101756fd760b4dacb5c3e99755703310 \
--hash=sha256:37503bfbfc9d2c40b344d06b2199cf0e96e97957ab1c1b546fd4f87e53e5d3e4 \
--hash=sha256:3c5677e12444c15717b902a5798264fa7909e41153cdf9ef7ad571b704a63dd9 \
--hash=sha256:3ff07ec89bae51176c0549bc4c63aa6202991da2d9a6129d7aef7f1407d3f295 \
--hash=sha256:41715c910c881bc081f1e8872880d3c650acf13dfa8214bad49ed4cede7c34ea \
--hash=sha256:418cf3f2111bc80e0933b2cd8cd04f286338bb88bdc7bc8e6dd775ebde60b5e0 \
--hash=sha256:44edc647873928551a01e7a563d7452ccdebee747728c1080d881d68af7b997e \
--hash=sha256:4a2e8cebe2ff6ab7d1050ecd59c25d4c8bd7e6f400f5f82b96557ac0abafd0ac \
--hash=sha256:4ad1906908f2f5ae4e5a8ddfce73c320c2a1429ec52eafd27138b7f1cbe341c9 \
--hash=sha256:501a031947e3a9025ed4405a168e6ef5ae3126c59f90ce0cd6f2bfc477be31b7 \
--hash=sha256:5190d403f121660ce8d1d2c1bb2ef1bd05b5f68533fc5c2ea899bd15f4399b35 \
--hash=sha256:5498cd1645aa724a7c71c8f378eb29ebe23da2fc0d7a08071d89469bf1d2defb \
--hash=sha256:5cf4e27da7e3fbed4d6c3d8e797387aaad68102272f8f9752883bc32d61cb87b \
--hash=sha256:5e0b74767e5f8c593e8c9b5912019159ed0533c70051e9cce3e8b6aa699fcd69 \
--hash=sha256:5ed875a24292240029e4483f9d4a4b8a1ae08843b9c54f43fcc11e404532a8a5 \
--hash=sha256:5fcd34e47f6e0b794d17de1b4ff496c00986e1c83f7ab2fb8fcfe9616ff7477b \
--hash=sha256:5fdec68f91a0c6739b380c83b951e2c72ac0197ace422360e6d5a959d8d97b2c \
--hash=sha256:6344df0d5755a2c9a276d4473ae6b90647e216ab4757f8426893b5dd2ac3f369 \
--hash=sha256:64386e5e707d03a7e172c0701abfb7e10f0fb753ee1d773128192742712a98fd \
--hash=sha256:652cb6edd41e718550aad172851962662ff2681490a8a711af6a4d288dd96824 \
--hash=sha256:66291b10affd76d76f54fad28e22e51719ef9ba22b29e1d7d03d6777a9174198 \
--hash=sha256:66e1674c3ef6f541c35191caae2d429b967b99e02040f5ba928632d9a7f0f065 \
--hash=sha256:6adc77889b628398debc7b65c073bcb99c4a0237b248cacaf3fe8a557563ef6c \
--hash=sha256:79005a0d97d5ddabfeeea4cf676af11e647e41d81c9a7722a193022accdb6b7c \
--hash=sha256:7c6610def4f163542a622a73fb39f534f8c101d690126992300bf3207eab9764 \
--hash=sha256:7f047e29dcae44602496db43be01ad42fc6f1cc0d8cd6c83d342306c32270196 \
--hash=sha256:8098f252adfa6c80ab48096053f512f2321f0b998f98150cea9bd23d83e1467b \
--hash=sha256:850774a7879607d3a6f50d36d04f00ee69e7fc816450e5f7e58d7f17f1ae5c00 \
--hash=sha256:8d1fab6bb153a416f9aeb4b8763bc0f22a5586065f86f7664fc23339fc1c1fac \
--hash=sha256:8da9669d359f02c0b91ccc01cac4a67f16afec0dac22c2ad09f46bee0697eba8 \
--hash=sha256:8dc52c23056b9ddd46818a57b78404882310fb473d63f17b07d5c40421e47f8e \
--hash=sha256:9149cad251584d5fb4981be1ecde53a1ca46c891a79788c0df828d2f166bda28 \
--hash=sha256:93dda82c9c22deb0a405ea4dc5f2d0cda384168e466364dec6255b293923b2f3 \
--hash=sha256:96b533f0e99f6579b3d4d4995707cf36df9100d67e0c8303a0c55b27b5f99bc5 \
--hash=sha256:9c57bb8c96f6d1808c030b1687b9b5fb476abaa47f0db9c0101f5e9f394e97f4 \
--hash=sha256:9c7708761fccb9397fe64bbc0395abcae8c4bf7b0eac081e12b809bf47700d0b \
--hash=sha256:9f3bfb4965eb874431221a3ff3fdcddc7e74e3b07799e0e84ca4a0f867d449bf \
--hash=sha256:a33284e20b78bd4a18c8c2282d549d10bc8408a2a7ff57653c0cf0b9be0afce5 \
--hash=sha256:a80cb027f6b349846a3bf6d73b5e95e782175e52f22108cfa17876aaeff93702 \
--hash=sha256:b30236e45cf30d2b8e7b3e85881719e98507abed1011bf463a8fa23e9c3e98a8 \
--hash=sha256:b3bc83488de33889877a0f2543ade9f70c67d66d9ebb4ac959502e12de895788 \
--hash=sha256:b865addae83924361678b652338317d1bd7e79b1f4596f96b96c77a5a34b34da \
--hash=sha256:b8bb0864c5a28024fac8a632c443c87c5aa6f215c0b126c449ae1a150412f31d \
--hash=sha256:ba1cc08a7ccde2d2ec775841541641e4548226580ab850948cbfda66a1befcdc \
--hash=sha256:bdb2c67c6c1390b63c6ff89f210c8fd09d9a1217a465701eac7316313c915e4c \
--hash=sha256:c1ff362665ae507275af2853520967820d9124984e0f7466736aea23d8611fba \
--hash=sha256:c2514fceb77bc5e7a2f7adfaa1feb2fb311607c9cb518dbc378688ec73d8292f \
--hash=sha256:c3355370a2c156cffb25e876646f149d5d68f5e0a3ce86a5084dd0b64a994917 \
--hash=sha256:c458b6d084f9b935061bc36216e8a69a7e293a2f1e68bf956dcd9e6cbcd143f5 \
--hash=sha256:d0eae10f8159e8fdad514efdc92d74fd8d682c933a6dd088030f3834bc8e6b26 \
--hash=sha256:d76623373421df22fb4cf8817020cbb7ef15c725b9d5e45f17e189bfc384190f \
--hash=sha256:ebc55a14a21cb14062aa4162f906cd962b28e2e9ea38f9b4391244cd8de4ae0b \
--hash=sha256:eda16858a3cab07b80edaf74336ece1f986ba330fdb8ee0d6c0d68fe82bc96be \
--hash=sha256:ee2922902c45ae8ccada2c5b501ab86c36525b883eff4255313a253a3160861c \
--hash=sha256:efd7b85f94a6f21e4932043973a7ba2613b059c4a000551892ac9f1d11f5baf3 \
--hash=sha256:f7057c9a337546edc7973c0d3ba84ddcdf0daa14533c2065749c9075001090e6 \
--hash=sha256:fa160448684b4e94d80416c0fa4aac48967a969efe22931448d853ada8baf926 \
--hash=sha256:fc09d0aa354569bc501d4e787133afc08552722d3ab34836a80547331bb5d4a0
# via
# mkdocs
# mkdocs-get-deps
# properdocs
# pymdown-extensions
# pyyaml-env-tag
pyyaml-env-tag==1.1 \
--hash=sha256:17109e1a528561e32f026364712fee1264bc2ea6715120891174ed1b980d2e04 \
--hash=sha256:2eb38b75a2d21ee0475d6d97ec19c63287a7e140231e4214969d0eac923cd7ff
# via
# mkdocs
# properdocs
requests==2.34.2 \
--hash=sha256:2a0d60c172f83ac6ab31e4554906c0f3b3588d37b5cb939b1c061f4907e278e0 \
--hash=sha256:f288924cae4e29463698d6d60bc6a4da69c89185ad1e0bcc4104f584e960b9ed
# via mkdocs-material
tzdata==2026.6 \
--hash=sha256:0a10eec6e13ef16b627fabed9a5f2ba61a62b1c67f327305f4e7e412a70b4aec \
--hash=sha256:85d2cd9c09f81f0bb29db27759fc83af4f1e620efb814f8c5bf8b4cc4feece6d
# via python-dateutil
urllib3==2.8.0 \
--hash=sha256:0cf3cae568d36aa9576b28dfb35f11328f1cb974ca7647d9475ebb86c75ac6e3 \
--hash=sha256:63bf2ead4c879426ebf22ef2a781eeb4aa3b4ae798a0435506f8687fd5bb9b63
# via requests
watchdog==7.1.0 \
--hash=sha256:0cfc5a6b3d4e76fc3e18fd371ee79d57945004da4105b589f71bb16966fd3e67 \
--hash=sha256:16a5ba8694587cdbeae4ab8e6434cece994f9cce4e5bab03e61e6d1a0a93a643 \
--hash=sha256:22d8869d9cb822c735923eea39d9279f03d5fd23e6d325800ac9e402e34c0a28 \
--hash=sha256:22fb8c80a2e510ec7773e4f6b2c6db869c2aed80bfb09962feb0962eb54f3ac9 \
--hash=sha256:24bf3345278ed7861438cd1ff162888e955250124d1e3c122f9be1d5c2a142c3 \
--hash=sha256:2dc548262230493c8740c50cb0016d5983143ef3e587284d55f8a9fac393340f \
--hash=sha256:33501d3ab5627e41b6230d5f92e651ea843b1d236cf2b135959dfda2d42d2f69 \
--hash=sha256:3dcf1a72c8c83a945e99965746c818bca3f50c0835b66ef1deb388d89bae792a \
--hash=sha256:400788184d62c0e384da67de4d7fcb892bfeb064b2e59a7d1a1dccb9ff4b49bc \
--hash=sha256:4332ae52b5e530d2c25a8525d765f1d34e595cfb07096c6b6368f9da10b5a8bf \
--hash=sha256:48db8dd8f9f92359ca5d4bccbd82be814facc3f57feaa3c67be964cc86b1dc33 \
--hash=sha256:5047bc32663aa6c8a720940072a64cd648f4c6c6f34cd43592719bcc880b7465 \
--hash=sha256:531f1a21bf0d37ea82be9a717ab92c05ab6f2f32ec6c1f2e7a748f9cfd21c8b2 \
--hash=sha256:550ff9204139b6d759cd37210935bb88f6aac42542ad17516edaf17c9b35fd41 \
--hash=sha256:5ed4b94365c53ffd51d88e47ca48d6afae02fb1bd849175a9a10927a2fbfb932 \
--hash=sha256:701586db59c9c421389e2e007713a821d934c3d83d034f0cafa95516a422758d \
--hash=sha256:71b0ebfd5b3ffe7cf53143f2ab63fa5038ca190fc10782ec23202765a859b057 \
--hash=sha256:77f06d709fe5d766ec51ec07b79773f5e29a0b3c4c3d195cfc7aa1e909fa566c \
--hash=sha256:84a196f6259d18ce53cc58f211f7d0184939dbbfaaebae6efc509cec333ba9ea \
--hash=sha256:89f78b2b1c153715463e27fc86f0f95fd4dd6cb07a2cdad932fe01840101fb5a \
--hash=sha256:8b637a1525d7e23548419368485bf1de931aca4c9e132e89a41bad52ff435fca \
--hash=sha256:9c937139c8afdb26405639309956352ef72c453006e772e0cf5c0bbc0d1cba82 \
--hash=sha256:a0fdb62a48b5073ea3bcca29b9910f1cbde1026ab8bffb87a69b112bf6d97d1c \
--hash=sha256:a17f37720ea088430754a7cc5869fad93915c69eaff8d5284adbac41f1befaaa \
--hash=sha256:a47d6e1418d7ed80f69454fb7f000ded554363209f8b04b812bf46b6c9e3093f \
--hash=sha256:a78673ab08b15f42760ae036f9251d02ac4107390c074963ccad4fc91cf880ac \
--hash=sha256:a79b77db565ae3bc9ff490df2ce51a4bdd6b344a99732055e828e8dadaaf1c97 \
--hash=sha256:ad6d0b473cb8cde0721692b22b30fcbea8b52102430528874b3593549888bd81 \
--hash=sha256:b0747551092578b70a4e8c48260ab956a9aa7efd2e9f7614471a7f73ada91c44 \
--hash=sha256:b1a669c90ae6dc734f2a5a417f15ba30d5ef41d890bc28aef161d51bb62b7882 \
--hash=sha256:b390a8a0b85a93882d2ad27cbcc222e1e93293a5410d2ceffb48c0fdb38e0b17 \
--hash=sha256:b76e3ac088550b33046c4eabacdd7dd4cb9db9147c8749b202643a4b5c2433c8 \
--hash=sha256:bb9182d0b0b75a78137ea9ae8d74943e53ebc3fc5ea11178fdb3da32ced6ef18 \
--hash=sha256:be3f5f953b11bde13ee3c54ae740948f61b01b6b79442f92ff5b9d0c15e5b7e7 \
--hash=sha256:c71bd120d57b16c2c49abd55d74d3c83f984e19024249ebe7ba4dc4903eb27ee \
--hash=sha256:cbae4a087f712bac4086e653273a949f86e2f908d16f157fd3568217e0c07cbe \
--hash=sha256:cf55c6108cce5c590661ebf3345d5203b6c6455237d73122a64acb74acc6a920 \
--hash=sha256:d3861e255416f49a1384474cb2efa097de165fb330d4c5432ce6708b509ed922 \
--hash=sha256:d47f3067eb77a83d04de1cac214284da604f960eaee9816d7ebfd01a165b4175 \
--hash=sha256:d4c9804d3db8e18659cd7cd968e2dbb31a655d12fcc07ec54df5ae47ff929f50 \
--hash=sha256:d94d0bcf30a9ea5ac5387df290b9e175c04747558c33443d2b0f763471699531 \
--hash=sha256:dbd4e701a31b9bfa686bd831177b433695f5e4dabee6aa0bdf4efcf6f0fd5b9f \
--hash=sha256:e226f1797764c3995ff9e91ce46f1b2ae65f59ab231785ef2f62243f06ba7956 \
--hash=sha256:fb84cdb12a3c4c273d71e4e5a4f76861fbf8f49bc9ca5be86f085ab6f57c683f
# via
# mkdocs
# properdocs