The infrastructure under Mukoko, the Nyuchi products and the Bundu commons.

Ubuntu — I am because we are. Ndiri nekuti tiri.

nyuchi.com · services.nyuchi.com · docs.nyuchi.com · mukoko.com · bundu.org

The Nyuchi Architecture · Governance · Contributing · Security · Support

Nyuchi Africa operates everything that runs: identity, the API gateway, the databases, the pipelines, the edge and the Console. Nyuchi is the infrastructure.

The ecosystem stands on three pillars:

The Nyuchi Architecture v5.0.0 (October 2026) is the canonical technical reference. Where it disagrees with any other document in this organisation, it wins; where the running system disagrees with it, the system is right and the document gets fixed. Every component in it is marked Live, Building, Designed or Goal.

• The Nyuchi API — api.nyuchi.com/v1, FastAPI on Fly.io (nyuchi/api-gateway, private). It is the internal API for every app in the Bundu ecosystem and the only thing that connects to a database. Every database is reached through it. First-party Mukoko apps and the Nyuchi products call it directly, each with its own client ID and secret. Live.
• Data infrastructure — deploy config for the self-hosted data services (Doris, Flink, Redpanda, CouchDB, archived Supabase migrations) lives in nyuchi/data-infra (private). Only the Nyuchi API connects to any of them.
• The Mukoko API — api.mukoko.com (mukoko-dev/mukoko-api), Cloudflare Workers, no database access. The public consumer API: each Mukoko app's public API lives there by namespace, for example api.mukoko.com/v1/weather rather than weather.mukoko.com/api. Building.
• Identity — WorkOS AuthKit, issuer accounts.mukoko.com, branded as Mukoko Account. Stytch is retired. Live.
• Data — Supabase PostgreSQL 17 in four projects (nyuchi_relational_db is the primary; nyuchi_pay_db, shamwari_ai_db, mzizi_db) and MongoDB Atlas for everything non-relational. Live.
• The Console — platform.nyuchi.com (nyuchi/nyuchi-platform, private). Live.

An open set, not a fixed number: the market decides which doors earn a place. Today they are the API Platform, Web Services, Learning, Medical, Logistics, Tools, Pay, Masasa and StationKit. Each one's status is in the Architecture, §12.

The Mukoko app repositories (mukoko-news, mukoko-news-gateway, mukoko-ingestion-pipeline, mukoko-weather, mukoko-weather-mobile, mukoko-events-admin, mukoko-events-mcp, bushtrade) and nyuchi-identity have moved to mukoko-dev.

• Most of what we write is open; not everything we run is. Public by default, private only when necessary. Every repository declares an open licence, source-visible (all rights reserved), or private. Check the LICENSE file in the repository you are working with.
• Conventional Commits. Every commit and PR title follows conventionalcommits.org.
• CI is the source of truth. Lint is an org-required workflow: every org ruleset runs its .github repo's org-lint.yml on every pull request and requires the five lint checks — see the reusable workflows that power it.
• Agents have rules too. AGENTS.md governs AI-assisted contributions.

Read CONTRIBUTING.md before opening a PR.

Three documents describe how Nyuchi Africa is organised, how we licence our work and how our engineers build. They predate v5; where they disagree with the Architecture, the Architecture wins (see GOVERNANCE.md).

• NA-01 Constitution — corporate governance, decision rights, and the relationship with the Bundu Foundation.
• NA-02 Open Source & Contribution Governance — licensing posture, contribution process and sovereignty commitments.
• NA-03 Engineering Working Agreement — engineering principles and merge blockers.

• Browse our repositories.
• Full product catalogue at services.nyuchi.com.
• Report security issues privately via SECURITY.md.
• Questions? See SUPPORT.md.

Our open projects use MIT, Apache 2.0, and occasionally GPL or AGPL, depending on the component; some public repositories are source-visible with all rights reserved. Always check the LICENSE file in the specific repository.

Operated by Nyuchi Africa · Governed by the Bundu Foundation · Mukoko is the first tenant.