← Back to Research Hub
🐙

Takopi Architecture

Key Insights

  • Plugin overlay pattern: 225 custom lines via Python entry points extend upstream (23K) without forking - maintains compatibility while adding behavior
  • Auto-discovery: Shell script scans filesystem and generates TOML dynamically - zero-config project addition via convention
  • Graceful restart via exit(0): /reload exits cleanly, supervisor restarts, entrypoint re-scans - no complex state serialization
  • Minimal code surface: Delegates complexity to upstream, only adds routing layer - minimizes maintenance burden
  • Container-to-host bridge: /refresh uses dbus to trigger systemd from inside container - bridges bot with host infrastructure