🐙 takopi-matrix

Matrix transport backend for takopi.

Features

• Matrix protocol support via matrix-nio
• End-to-end encryption (E2EE) by default
• Voice message transcription (OpenAI Whisper)
• File download support
• Interactive onboarding wizard
• Multi-room support with per-room engine defaults
• Project-to-room binding

Requirements

• Python ≥3.14
• libolm 3.x (for E2EE)
• takopi ≥0.18

Installation

1. Install libolm

2. Install takopi-matrix

pip install takopi-matrix

Or with uv:

uv tool install takopi --with takopi-matrix

Configuration

Interactive Setup

takopi --onboard

Manual Configuration

Add to ~/.takopi/takopi.toml:

transport = "matrix"

[transports.matrix]
homeserver = "https://matrix.example.org"
user_id = "@bot:example.org"
access_token = "syt_your_access_token"
room_ids = ["!roomid:example.org"]

# Optional: per-room engine defaults
[transports.matrix.room_engines]
"!room1:example.org" = "claude"
"!room2:example.org" = "codex"

# Optional: project-to-room binding
[transports.matrix.room_projects]
"!room1:example.org" = "myproject"

Documentation

• Matrix Transport Reference - Full configuration options
• Architecture Overview - System design
• Development Setup - Contributing guide

License

MIT