{"id":34090093,"url":"https://github.com/nouman0103/winerp","last_synced_at":"2026-04-02T01:01:26.391Z","repository":{"id":40458215,"uuid":"478205505","full_name":"nouman0103/winerp","owner":"nouman0103","description":"An IPC based on Websockets, fast, stable, and reliable","archived":false,"fork":false,"pushed_at":"2023-09-01T15:01:02.000Z","size":176,"stargazers_count":13,"open_issues_count":3,"forks_count":9,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-12-16T17:15:52.191Z","etag":null,"topics":["asyncio","communication","discord","discord-ipc","inter-process-communication","inter-server-communications","ipc","websocket","websockets"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/winerp/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nouman0103.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":null,"security":null,"support":null}},"created_at":"2022-04-05T16:08:39.000Z","updated_at":"2025-08-11T07:04:45.000Z","dependencies_parsed_at":"2022-08-09T21:01:20.390Z","dependency_job_id":null,"html_url":"https://github.com/nouman0103/winerp","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/nouman0103/winerp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nouman0103%2Fwinerp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nouman0103%2Fwinerp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nouman0103%2Fwinerp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nouman0103%2Fwinerp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nouman0103","download_url":"https://codeload.github.com/nouman0103/winerp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nouman0103%2Fwinerp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31293631,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T21:15:39.731Z","status":"ssl_error","status_checked_at":"2026-04-01T21:15:34.046Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["asyncio","communication","discord","discord-ipc","inter-process-communication","inter-server-communications","ipc","websocket","websockets"],"created_at":"2025-12-14T14:10:44.677Z","updated_at":"2026-04-02T01:01:26.382Z","avatar_url":"https://github.com/nouman0103.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# winerp\nAn IPC based on Websockets. Fast, Stable, and easy-to-use, for inter-communication between your processes or discord.py bots.\n\nDocumentation: https://winerp.readthedocs.io/  \nDiscord Server: https://discord.gg/T28F8hju9Y\n\n\u003e **BREAKING CHANGES (1.4.0):**  \nThe message source name is passed to all registered routes.\nInstead of:\n\u003e ```py\n\u003e @ipc.route() # \u003c v1.4.0\n\u003e async def route_name():\n\u003e     ...\n\u003e ```\n\u003e Use: \n\u003e ```py\n\u003e @ipc.route() # \u003e= v1.4.0\n\u003e async def route_name(source):\n\u003e     ...\n\u003e ```\n\n### Key Features\n\n - **Fast** with minimum recorded response time being `\u003c 2ms`\n - Lightweight, Stable and Easy to integrate.\n - No limitation on number of connected clients. \n\n## Installation\nStable:\n```py\npip install -U winerp\n```\nMain branch (can be unstable/buggy):\n```py\npip install git+https://www.github.com/BlackThunder01001/winerp\n```\n\n### Working:\nThis library uses a central server for communication between multiple clients. You can connect a large number of clients for sharing data, and data can be shared between any connected client.\n\n![winerp-server-working](https://user-images.githubusercontent.com/40216575/232253783-7f5b625e-a08d-4e3d-8306-50684ea396b6.png)\n\n\n1) Import the library:\n```py\nimport winerp\n```\n\n2) Initialize winerp client:\n```py\nipc_client = winerp.Client(local_name = \"my-cool-app\", port=8080)\n```\n\n3) Start the client:\n```py\nawait ipc_client.start()\n# or\nasyncio.create_task(ipc_client.start())\n```\n\n- Registering routes:\n```py\n@ipc_client.route\nasync def route_name(source, user_name):\n    return f\"Hello {user_name}\"\n```\n\n- Requesting data from another client:\n```py\nuser_name = await ipc_client.request(route=\"fetch_user_name\", source=\"another-cool-bot\", user_id = 123)\n```\n\n- Sending *information* type data to other clients:\n```py\ndata = [1, 2, 3, 4]\nawait ipc_client.inform(data, destinations=[\"another-cool-bot\"])\n```\n\n## Example Usage:\n\nStart the server on terminal using `$ winerp --port 8080`. You can also start the server using `winerp.Server`\n\n### Client 1 (`some-random-bot`):\n```py\nimport winerp\nimport discord\nfrom discord.ext.commands import Bot\nbot = Bot(command_prefix=\"!\", intents=discord.Intents.all())\n\nbot.ipc = winerp.Client(local_name = \"some-random-bot\", port=8080)\n\n@bot.command()\nasync def request(ctx):\n    # Fetching data from a client named \"another-bot\" using route \"get_some_data\"\n    data = await bot.ipc.request(\"get_some_data\", source = \"another-bot\")\n    await ctx.send(data)\n\n\n@bot.ipc.route()\nasync def get_formatted_data(source, user_id = None):\n    return f\"\u003c@{user_id}\u003e\"\n\n\n@bot.ipc.event\nasync def on_winerp_ready():\n    print(\"Winerp Client is ready for connections\")\n\nbot.loop.create_task(bot.ipc.start())\nbot.run(\"TOKEN\")\n```\n\n### Client 2 (`another-bot`)\n```py\nimport winerp\nimport discord\nfrom discord.ext.commands import Bot\nbot = Bot(command_prefix=\"?\", intents=discord.Intents.all())\n\nbot.ipc = winerp.Client(local_name = \"another-bot\", port=8080)\n\n@bot.command()\nasync def format(ctx):\n    # Fetching data from a client named \"some-random-bot\" using route \"get_formatted_data\"\n    data = await bot.ipc.request(\"get_formatted_data\", source = \"some-random-bot\", user_id = ctx.author.id)\n    await ctx.send(data)\n\n\n@bot.ipc.route()\nasync def get_some_data(source):\n    return \"You are very cool\"\n\n\nbot.loop.create_task(bot.ipc.start())\nbot.run(\"TOKEN\")\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnouman0103%2Fwinerp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnouman0103%2Fwinerp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnouman0103%2Fwinerp/lists"}