Corio
Corio is a practical Python toolkit for building small services, automation, data pipelines, and AI/ML support code without re-solving the same project plumbing every time.
It bundles the pieces that tend to sit between "standard library" and "application code": typed paths with serialization helpers, pydantic-friendly data models, CLI settings, structured logging spans, iterator progress, FastAPI/MCP endpoint scaffolding, release metadata generation, test environment generation, and opt-in integrations for docs, Docker, search, tabular data, PDFs, OpenAI, Home Assistant, DNS, caching, encryption, and more.
Corio is organized as one package with optional extras. Install the small core by default, then opt into the heavier tools a project actually needs.
Install
pip install corio
Examples:
pip install "corio[api]"
pip install "corio[tabular]"
pip install "corio[db.search]"
pip install "corio[infra]"
Why Use It
- Use paths as real application objects. Read and write JSON, YAML, TOML, text, and derived paths directly from
corio.Path. - Make CLIs from typed models. Corio builds on pydantic settings patterns so small tools can stay declarative.
- Wrap iteration with observability.
corio.iterator.Iteratortracks count, percentage, elapsed time, ETA, completion, and cleanup. - Expose tools as HTTP and MCP endpoints. Define endpoint classes once and mount them into FastAPI and MCP surfaces.
- Keep release metadata generated.
corio pyprojectturns Corio dependency groups and project metadata into the generatedpyproject.tomlsections. - Install integrations only when needed. Extras keep heavy dependencies like API servers, vector search, ML, PDFs, and tabular tooling out of the base install.
Examples
Typed Paths And Data Files
from corio import Path
path = Path("runs/latest/config.yaml")
path.parent.mkdirf()
path.write_data({
"model": "embedder-v2",
"batch_size": 64,
})
config = path.read_data()
json_path = path.get_conversion_path("json")
json_path.parent.mkdirf()
json_path.write_data(config)
Observable Iteration
from corio.iterator import Iterator
documents = [{"id": "a"}, {"id": "b"}, {"id": "c"}]
for document in Iterator(documents):
# Work happens inside per-item logging spans with progress stats.
process(document)
The iterator tracks count, total, percentage, elapsed time, rate, ETA, completion logs, and closes the wrapped iterator when possible.
FastAPI And MCP Tools
from functools import cached_property
from corio import api
class Search(api.endpoint.API):
"""Search indexed documents."""
PATH = "/search"
TAGS = "documents"
async def run(self, query: str):
return {"query": query, "results": []}
class Reindex(api.endpoint.Tool):
"""Rebuild the document index."""
async def run(self):
return {"status": "queued"}
class Service(api.Base):
TITLE = "Document Service"
PORT = 8080
@cached_property
def ENDPOINTS(self):
return [Search, Reindex]
Service().launch()
The same endpoint model can feed HTTP routes and MCP tools, so internal automation and external APIs stay aligned.
Project Metadata
Corio projects keep dependency intent in [tool.corio.dependencies]; generated package metadata lives in [project.optional-dependencies].
[tool.corio.dependencies]
semantic = ["sentence_transformers", "metrics"]
metrics = ["tabular", "ranx"]
tabular = ["pandas", "tabulate", "openpyxl", "odfpy", "deepdiff"]
Then regenerate:
corio pyproject
That keeps extras flattened for packaging while preserving a maintainable source-of-truth dependency graph.
Useful Areas
corio.path: typed path helpers, app paths, file type guessing, serialization helpers.corio.dmandcorio.sets: pydantic-oriented models and settings/CLI support.corio.api: FastAPI and MCP endpoint composition.corio.iterator: progress-aware iterable wrapper and small collection helpers.corio.infra: release, docs, tox, and pyproject generation tooling.corio.db.search: vector search helpers around qdrant and embeddings.corio.tabular,corio.semantic,corio.metric: data and retrieval metrics helpers.corio.encrypt,corio.sec: project secret and encryption workflows.corio.ha,corio.dns,corio.mqtt,corio.webhook: operations and home automation integrations.
Documentation
- Published docs: https://fmtr.github.io/corio
- Local docs source: docs
License
This project is licensed under Apache 2.0. See LICENSE.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file corio-2.8.9.tar.gz.
File metadata
- Download URL: corio-2.8.9.tar.gz
- Upload date:
- Size: 137.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.14.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2de9f1a3512d054ec637ced4b3aefd7775d8cae4decc418c901bc321f5776b70
|
|
| MD5 |
b09893d2a835646b0f3855b763fceffe
|
|
| BLAKE2b-256 |
5233239ff6cfa686afcd438fc0e650ba1c3bec76cc339b0fa2a587b3ea8091ee
|
File details
Details for the file corio-2.8.9-py3-none-any.whl.
File metadata
- Download URL: corio-2.8.9-py3-none-any.whl
- Upload date:
- Size: 170.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.2.0 CPython/3.14.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4bdc4bb1901dc9cdc2e1d289f260dbcc619fb09dafde32cf522052e7d706270c
|
|
| MD5 |
eb4d97a0ae36391ec870f0fd31955437
|
|
| BLAKE2b-256 |
da1e518534b30b83acbf391015468c3a334d811add723db35f4451ef1c98f42f
|
