This release is a pre-release and may not be stable for production use.
Oremi Kànsà
Oremi Kànsà is an MCP server for discovering podcasts through the Podcast Index. It provides AI assistants and autonomous agents with a standardized interface to search, browse, and retrieve podcast information using the Model Context Protocol (MCP).
Designed to run in Docker, Oremi Kànsà exposes tools for searching podcasts, exploring episodes, browsing categories, and retrieving metadata from Podcast Index. It enables MCP-compatible clients to access podcast content without interacting directly with the Podcast Index API.
The name Oremi Kànsà comes from the Yoruba language. Oremi means "my friend", reflecting the project's goal of building a helpful and trustworthy AI ecosystem. Kànsà is derived from the Yoruba word associated with broadcasting or broadcast media, representing the service's responsibility for helping AI agents discover podcast content through a unified MCP interface.
Core Capabilities
- Search and discover podcasts by topic, language, and category
- Retrieve detailed podcast and episode metadata
- Browse categories, trending shows, and related podcasts
- Return structured, validated response models for MCP clients
- Use either the public Podcast Index API or the offline SQLite catalog
- Accelerate searches with persistent FTS5 indexes and a bounded memory cache
- Persist and periodically refresh the catalog in
/oremi/datain Docker - Run with multiple Docker Swarm replicas against the same cluster-shared volume
- Configure database updates, HTTP timeouts, HTTP binding, API prefix, and logging through environment variables
- Serve MCP over Streamable HTTP
- Run as a lightweight Docker container with simple deployment.
- Integrate seamlessly with the Oremi ecosystem and other MCP-compatible clients.
Documentation
All project documentation—including architecture details, configuration reference, and the Home Assistant integration guide—can be found at: https://demsking.gitlab.io/oremi-kansa/
Development
Oremi Kànsà is built with Python and uses uv for dependency management. The
project follows standard Python development practices with type hints, linting,
and automated testing.
For detailed information on setting up your development environment, running tests, code style guidelines, and the pull request process, please refer to CONTRIBUTING.md.
Versioning
This project adheres to Semantic Versioning (SemVer).
Version numbers follow the MAJOR.MINOR.PATCH format:
- MAJOR version increments for incompatible API changes
- MINOR version increments for backward-compatible new functionality
- PATCH version increments for backward-compatible bug fixes
License
Copyright 2026 Sébastien Demanou. All Rights Reserved.
Licensed under the Apache License, Version 2.0. See the LICENSE for the complete license text.
1 maintainer
Metadata
1 maintainer
Release files for oremi-kansa 1.0.0b11
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| oremi_kansa-1.0.0b11-py3-none-any.whl | Python 3 | none | any | Details for oremi_kansa-1.0.0b11-py3-none-any.whl |
Release files / oremi_kansa-1.0.0b11-py3-none-any.whl
| Download URL | oremi_kansa-1.0.0b11-py3-none-any.whl |
|---|---|
| Size | 40.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
cda1c2750b112f092220fc9f6fe1a2e3346912d150e1baaec8fea5fa1d16bae6
|
|
BLAKE2b-256 checksum How to use checksums |
4e38727c8f9723ce86a93dedba028778a67c3a5356748c48c59e04bdbb63ce56
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.11
|
Security for oremi-kansa 1.0.0b11
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.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
