oto-core

Repository: otomata-tech/connectors — renamed on 2026-09-14. The PyPI package keeps the name oto-core, and so does the import namespace oto.*.

Connector library for Oto — pure Python API clients for AI agents and automation. No command line, no server: clients return plain dicts.

Credentials are always provided by the consumer. Every client takes its secret (API key, token, OAuth credentials…) as a constructor argument; the library never reads secrets from the environment, files or a secret provider, and a missing one raises oto.tools.common.credentials.MissingCredential.

pip install oto-core              # core (requests, france-opendata)
pip install "oto-core[google]"    # + Google Workspace (Drive, Docs, Sheets, Gmail, Calendar, Tasks)
pip install "oto-core[browser]"   # + browser-based scraping (LinkedIn, via o-browser)
pip install "oto-core[stock]"     # + SIRENE stock queries (DuckDB/parquet)

What's inside

oto.tools.* — one client per service: French company data (SIRENE, INPI, BODACC, BOAMP, DVF via france-opendata), web search (Serper), email finding (Hunter), CRM (Attio, Folk), outreach (Lemlist, Kaspr, Fullenrich), Google Workspace, Slack, WhatsApp, Reddit, Pennylane, Silae (French payroll), and more.
oto.tools.common.FieldFilter — reusable response redaction (mask IBANs, anonymize names, drop fields) any connector can apply; driven by code or a field_filters.<service> policy in ~/.otomata/config.yaml.
oto.tools.common.scrub — pseudonymises sensitive values written inside free text (social security numbers, IBANs, cards, e-mails, phones, secrets by their shape; names, addresses and credentials through an OpenAI-compatible model that only points at passages), each replaced by a stable keyed token; the scrub action of FieldFilter.

Shared connector descriptions

New shared connectors are described once, in YAML: connectors/<name>/connector.yaml, validated by connectors/connector.schema.json. A generator (the fabrique) turns each description into a Python client and TypeScript functions. Design docs (in French): docs/conception/README.md, description format, generator.

Ecosystem

Package	Role
oto-core (this)	the clients — single source of truth
oto-backend	hosted platform (mcp.oto.cx — MCP + REST, credential vault, orgs); pins a git version of this library
oto 2 npm package	upcoming consumer of the shared connectors, through the generator
bridge-boilerplate (private)	skeleton of a bridge: an internal HTTP micro-service the platform calls through its generic `http` connector, when the logic must be deterministic or a credential must stay out of the platform. Not a client — it does not live here

from oto.tools.sirene import SireneClient

client = SireneClient(api_key="…")   # the consumer passes the key
company = client.get_company("130025265")

Conventions: clients are import-lazy per optional dependency, raise on error (no silent fallbacks), and stay free of printing concerns.

MIT — © Otomata.

Metadata

Release files for oto-core 1.181.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for oto-core 1.181.0
File	Size	Uploaded
oto_core-1.181.0.tar.gz	883.7 kB	Oct 16, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for oto-core 1.181.0
File	Interpreter	ABI	Platform	Reset
oto_core-1.181.0-py3-none-any.whl 1.1 MB Oct 16, 2026	Python 3	none	any	Details

Total release size: 2.0 MB

Release files / oto_core-1.181.0.tar.gz

Download URL	oto_core-1.181.0.tar.gz
Size	883.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`c7bfa16596ac3deb80ce4a1e327cadf99a6e9642097b37f69473f34d84dd7a7d`
BLAKE2b-256 checksum How to use checksums	`6ba4469828fe9ce9ff71f26b05c6fefab2219b003434bbc4ee22add9d813b07b`
Upload date	Oct 16, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/otomata-tech/connectors
Publishing commit: github.com/otomata-tech/connectors/tree/18433e56932f3d7205182bfb445b755b53401387

Workflow

Publishing configuration: github.com/otomata-tech/connectors/blob/18433e56932f3d7205182bfb445b755b53401387/.github/workflows/publish.yml
Publishing logs: github.com/otomata-tech/connectors/actions/runs/38980717509/attempts/1

Artifact

Subject: oto_core-1.181.0.tar.gz
SHA-256 checksum: c7bfa16596ac3deb80ce4a1e327cadf99a6e9642097b37f69473f34d84dd7a7d Verifying attestations

Release files / oto_core-1.181.0-py3-none-any.whl

Download URL	oto_core-1.181.0-py3-none-any.whl
Size	1.1 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`57e5e8a3dd736649f270387fb5d323484acd63a34670b1c2535c448b8beecd7b`
BLAKE2b-256 checksum How to use checksums	`5051bd28113a35b22825e6c2dbeaa9011e1e07c75b05fe15b93488bb3f16a014`
Upload date	Oct 16, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/otomata-tech/connectors
Publishing commit: github.com/otomata-tech/connectors/tree/18433e56932f3d7205182bfb445b755b53401387

Workflow

Publishing configuration: github.com/otomata-tech/connectors/blob/18433e56932f3d7205182bfb445b755b53401387/.github/workflows/publish.yml
Publishing logs: github.com/otomata-tech/connectors/actions/runs/38980717509/attempts/1

Artifact

Subject: oto_core-1.181.0-py3-none-any.whl
SHA-256 checksum: 57e5e8a3dd736649f270387fb5d323484acd63a34670b1c2535c448b8beecd7b Verifying attestations