🐙 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

Platform	Command
Debian/Ubuntu	`sudo apt-get install libolm-dev`
Fedora	`sudo dnf install libolm-devel`
Arch Linux	`sudo pacman -S libolm`
openSUSE	`sudo zypper install libolm-devel`
macOS (Homebrew)	`brew 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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

takopi_matrix-0.4.0.tar.gz (209.3 kB view details)

Uploaded Feb 22, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

takopi_matrix-0.4.0-py3-none-any.whl (95.8 kB view details)

Uploaded Feb 22, 2026 Python 3

File details

Details for the file takopi_matrix-0.4.0.tar.gz.

File metadata

Download URL: takopi_matrix-0.4.0.tar.gz
Upload date: Feb 22, 2026
Size: 209.3 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for takopi_matrix-0.4.0.tar.gz
Algorithm	Hash digest
SHA256	`c0dcafd96098715f0f501ad3c033a1044d815fe06224def8d80039b3de2b5130`
MD5	`66c43a5d1b838c15e70043d3d8a6f546`
BLAKE2b-256	`bc8e45c57328838d40f51acbce7381dfb665f7870a75572daab9dbf409cb19cf`

See more details on using hashes here.

Provenance

The following attestation bundles were made for takopi_matrix-0.4.0.tar.gz:

Publisher: release.yml on Zorro909/takopi-matrix

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: takopi_matrix-0.4.0.tar.gz
- Subject digest: c0dcafd96098715f0f501ad3c033a1044d815fe06224def8d80039b3de2b5130
- Sigstore transparency entry: 976600553
- Sigstore integration time: Feb 22, 2026
Source repository:
- Permalink: Zorro909/takopi-matrix@c8031c8485b9e7d9cf3792765344e6ac3619aba5
- Branch / Tag: refs/tags/v0.4.0
- Owner: https://github.com/Zorro909
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@c8031c8485b9e7d9cf3792765344e6ac3619aba5
- Trigger Event: push