Skip to main content

repid

Repid's logo

PyPI version Coverage Tests PyPI pyversions Read documentation


Repid is a simple, fast, and extensible async task queue framework, with built-in AsyncAPI 3.0 schema generation.


pip install repid

Features

  • AsyncAPI 3.0 out of the box - your schema is generated automatically as you build. No separate spec files to maintain, no drift between code and docs.

  • Broker flexibility - works with RabbitMQ, Redis, AWS SQS, Kafka, NATS, and Google Cloud Pub/Sub. Switch or run multiple brokers side by side without changing your actor code.

  • Extreme performance - built for maximum throughput and minimal overhead, making it the fastest async task queue in the Python ecosystem.

  • Developer ergonomics - define actors as plain async functions with dependency injection and Pydantic argument validation.

  • Built for testability - a drop-in TestClient lets you test actors in-memory without a running broker, making unit tests fast and dependency-free.

  • LLM-friendly documentation - grab llms.txt or llms-full.txt from the docs site to feed into your favorite AI coding assistant.

Quickstart

Here is how the simplest producer-consumer application looks, using AMQP server.

Producer:

import asyncio

from repid import AmqpServer, Repid

app = Repid(title="My App", version="1.0.0")
app.servers.register_server(
    "default",
    AmqpServer("amqp://user:password@localhost:5672"),
    is_default=True,
)


async def main() -> None:
    async with app.servers.default.connection():
        await app.send_message(
            channel="default",
            payload=b"",
            headers={"topic": "awesome_job"},
        )


asyncio.run(main())

Consumer:

import asyncio

from repid import AmqpServer, Repid, Router

app = Repid(title="My App", version="1.0.0")
app.servers.register_server(
    "default",
    AmqpServer("amqp://user:password@localhost:5672"),
    is_default=True,
)

router = Router()


@router.actor
async def awesome_job() -> None:
    print("Hello async jobs!")
    await asyncio.sleep(1.0)


app.include_router(router)


async def main() -> None:
    async with app.servers.default.connection():
        await app.run_worker()


asyncio.run(main())

Check out user guide to learn more!

License

Repid is distributed under the terms of the MIT license. Please see License.md for more information.

Repid's logo is distributed under the terms of the CC BY-NC 4.0 license. It is originally created by ari_the_crow_.

Download files

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

Source Distribution

repid-2.1.4.tar.gz (511.1 kB view details)

Uploaded Source

Built Distribution

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

repid-2.1.4-py3-none-any.whl (189.1 kB view details)

Uploaded Python 3

File details

Details for the file repid-2.1.4.tar.gz.

File metadata

  • Download URL: repid-2.1.4.tar.gz
  • Upload date:
  • Size: 511.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.29 {"installer":{"name":"uv","version":"0.11.29","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for repid-2.1.4.tar.gz
Algorithm Hash digest
SHA256 d71381b1c39b1caff0bbe060de77799a25fe50583d4ae7e206c0855a810447d8
MD5 80bdd000afb747a36d40bba0d0cedc82
BLAKE2b-256 4f9e4e24eac5cc3d79882b37869182e91bc6de038dc956f4db5a970e514a0ed7

See more details on using hashes here.

File details

Details for the file repid-2.1.4-py3-none-any.whl.

File metadata

  • Download URL: repid-2.1.4-py3-none-any.whl
  • Upload date:
  • Size: 189.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.29 {"installer":{"name":"uv","version":"0.11.29","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for repid-2.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 f3b8eed4294d5cee3175b379abd2082f615c532e1520af950ae561a43856a81b
MD5 f20403177fc4027cb41b8cf1daf4c0b4
BLAKE2b-256 788f039c358c2875260d41e03112f09a1d01a624986e9544b270ee3f6923df8b

See more details on using hashes here.

Release history Release notifications | RSS feed

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page