{"id":30715426,"url":"https://github.com/superstreamlabs/superclient-python","last_synced_at":"2026-01-20T17:38:09.047Z","repository":{"id":298167339,"uuid":"999098038","full_name":"superstreamlabs/superclient-python","owner":"superstreamlabs","description":null,"archived":false,"fork":false,"pushed_at":"2025-07-20T07:56:13.000Z","size":167,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-08-19T15:15:58.364Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/superstreamlabs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-09T18:26:47.000Z","updated_at":"2025-07-20T07:56:17.000Z","dependencies_parsed_at":"2025-06-24T14:34:02.589Z","dependency_job_id":"2f89aa0b-eed3-4178-a703-2c8e15b44e14","html_url":"https://github.com/superstreamlabs/superclient-python","commit_stats":null,"previous_names":["superstreamlabs/superclient-python"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/superstreamlabs/superclient-python","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/superstreamlabs%2Fsuperclient-python","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/superstreamlabs%2Fsuperclient-python/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/superstreamlabs%2Fsuperclient-python/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/superstreamlabs%2Fsuperclient-python/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/superstreamlabs","download_url":"https://codeload.github.com/superstreamlabs/superclient-python/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/superstreamlabs%2Fsuperclient-python/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273398093,"owners_count":25098300,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-03T02:00:09.631Z","response_time":76,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-09-03T06:08:22.061Z","updated_at":"2026-01-20T17:38:09.041Z","avatar_url":"https://github.com/superstreamlabs.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"https://github.com/user-attachments/assets/35899c78-24eb-4507-97ed-e87e84c49fea#gh-dark-mode-only\" width=\"300\"\u003e\n\u003cimg src=\"https://github.com/user-attachments/assets/8a7bca49-c362-4a8c-945e-a331fb26d8eb#gh-light-mode-only\" width=\"300\"\u003e\n\n\u003c/div\u003e\n\n# Superclient Python\n\nA Python library for automatically optimizing Kafka producer configurations based on topic-specific recommendations.\n\n## Overview\n\nSuperstream Clients works as a Python import hook that intercepts Kafka producer creation and applies optimized configurations without requiring any code changes in your application. It dynamically retrieves optimization recommendations from Superstream and applies them based on impact analysis.\n\n## Supported Libraries\n\n- kafka-python\n- aiokafka\n- confluent-kafka\n- Faust\n- FastAPI event publishers\n- Celery Kafka backends\n- Any custom wrapper around these Kafka clients\n\n## Features\n\n- **Zero-code integration**: No code changes required in your application\n- **Dynamic configuration**: Applies optimized settings based on topic-specific recommendations\n- **Intelligent optimization**: Identifies the most impactful topics to optimize\n- **Graceful fallback**: Falls back to default settings if optimization fails\n\n## Installation\n\n```bash\npip install superstream-clients \u0026\u0026 python -m superclient install_pth\n```\n\nThat's it! Superclient will now automatically load and optimize all Kafka producers in your Python environment.\n\n## Usage\n\nAfter installation, superclient works automatically. Just use your Kafka clients as usual.\n\n### Docker Integration\n\nWhen using Superstream Clients with containerized applications, include the package in your Dockerfile:\n\n```dockerfile\nFROM python:3.8-slim\n\n# Install superclient\nRUN pip install superstream-clients\nRUN python -m superclient install_pth\n\n# Your application code\nCOPY . /app\nWORKDIR /app\n\n# Run your application\nCMD [\"python\", \"your_app.py\"]\n```\n\n### Required Environment Variables\n\n- `SUPERSTREAM_TOPICS_LIST`: Comma-separated list of topics your application produces to\n\n### Optional Environment Variables\n\n- `SUPERSTREAM_LATENCY_SENSITIVE`: Set to \"true\" to prevent any modification to linger.ms values\n- `SUPERSTREAM_DISABLED`: Set to \"true\" to disable optimization\n- `SUPERSTREAM_DEBUG`: Set to \"true\" to enable debug logs\n\nExample:\n```bash\nexport SUPERSTREAM_TOPICS_LIST=orders,payments,user-events\nexport SUPERSTREAM_LATENCY_SENSITIVE=true\n```\n\n## Prerequisites\n\n- Python 3.8 or higher\n- Kafka cluster that is connected to the Superstream's console\n- Read and write permissions to the `superstream.*` topics\n\n## License\n\nApache License 2.0 ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsuperstreamlabs%2Fsuperclient-python","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsuperstreamlabs%2Fsuperclient-python","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsuperstreamlabs%2Fsuperclient-python/lists"}