Skip to content

v0.1.3

Choose a tag to compare

View all tags
@ruslanmv ruslanmv released this 24 Aug 20:15
· 34 commits to master since this release
v0.1.3
916d836

Release Notes — v0.1.3

Date: 2025-08-24
Focus: Move default Hub endpoint from local dev to production

✨ What changed

We’ve switched the default Hub base URL from a local development address to the public, production API:

  • Old: http://127.0.0.1:7300
  • New (default): https://api.matrixhub.io

This affects examples, docs, and any helper defaults that previously assumed a local Hub. There are no API surface changes in the SDK itself—only the default endpoint changed.

🧩 Why this matters

  • One-line getting started: New users can install and search the catalog without running a local Hub first.
  • Consistent environment: The default points to a stable, globally available service.
  • No breaking APIs: All client method signatures are unchanged.

🔄 Backwards compatibility

If you rely on a local Matrix Hub for development or testing, explicitly point the SDK to your local endpoint.

Option A — Code (recommended for tests/dev scripts):

from matrix_sdk import MatrixClient
client = MatrixClient(base_url="http://127.0.0.1:7300")

Option B — Environment variable (used by your own glue/CLIs):

export MATRIX_HUB_BASE="http://127.0.0.1:7300"

If you already pass base_url in your code, nothing changes for you.

✅ What to expect

  • Default behavior: New samples and helper defaults use https://api.matrixhub.io.
  • TLS/CA trust: Ensure your environment can reach *.matrixhub.io over HTTPS with a standard trust store.
  • No data migration: This release does not introduce schema or file layout changes.

🔍 Quick verification

from matrix_sdk import MatrixClient

# Uses the new production endpoint (if you pass it explicitly)
hub = MatrixClient(base_url="https://api.matrixhub.io")

res = hub.search(q="hello world", type="any", limit=3)
print([it.get("id") for it in res.get("items", [])])

To verify against local dev:

hub = MatrixClient(base_url="http://127.0.0.1:7300")

🧪 Impacted docs & examples

  • Updated all getting-started snippets to use the production endpoint.
  • Notes added to usage docs about overriding via code or MATRIX_HUB_BASE.

🧯 Known considerations

  • Corporate proxies / strict egress: allowlist api.matrixhub.io.
  • Mixed environments: be explicit in CI and local scripts to avoid accidental cross-environment tests.

Thanks for building with Matrix! If you run into any hiccups with the new default, please open an issue with your environment details (OS, Python version, network constraints).

Assets 4
Loading