feat: Implement py-peer of Universal Connectivity dApp by sumanjeet0012 · Pull Request #294 · libp2p/universal-connectivity

sumanjeet0012 · 2025-07-04T18:04:46Z

Python Implementation of Universal Connectivity Chat Application

Overview

This PR implements a complete Python peer-to-peer chat application using libp2p and GossipSub protocol, addressing the request for a Python peer in the Universal Connectivity project.

Related Issue

Fixes: libp2p/py-libp2p#624

Implementation Details

Core Features

Peer-to-Peer Chat: Real-time messaging using GossipSub pubsub protocol
Multiple UI Modes:
- Textual TUI interface for rich terminal experience
- CLI mode for simple interactive chat
- Headless mode for background operation
Peer Discovery: Manual connection to other peers using Multiaddr
System Logging: Structured logging with timestamped system events

Technical Stack

libp2p: Core peer-to-peer networking (py-libp2p 0.2.9)
Trio: Async/await framework for concurrent operations
Textual: Modern terminal user interface framework
GossipSub: Publish-subscribe messaging protocol
TCP Transport: Reliable connection transport (QUIC support planned)

Key Components

main.py - Application entry point with argument parsing
chatroom.py - Chat room logic and message handling
headless.py - Background service managing libp2p operations
ui.py - Textual-based terminal user interface

Usage Examples

# Start with Textual TUI
py-peer --nick "Sumanjeet" --ui

# Connect to specific peer
py-peer --nick "Devs" --connect /ip4/127.0.0.1/tcp/PORT/p2p/PEER_ID

# Headless mode
py-peer --nick "User" --headless

Testing

✅ Multi-peer chat sessions tested
✅ Peer discovery and connection verified
✅ All UI modes functional
✅ Cross-platform compatibility (Linux/macOS/Windows)

Dependencies

Python 3.12+
All dependencies managed via pyproject.toml with uv.lock for reproducible builds

Documentation

Comprehensive README with installation, usage, and troubleshooting
Architecture diagrams and component descriptions
Screenshot of working Textual UI interface

Additional Notes

Uses TCP transport currently; QUIC support may be added in future
Follows Python best practices with type hints and async patterns
Modular architecture allows easy extension and customization

Bumps the npm_and_yarn group in /js-peer with 1 update: [next](https://github.com/vercel/next.js). Updates `next` from 14.2.13 to 14.2.25 - [Release notes](https://github.com/vercel/next.js/releases) - [Changelog](https://github.com/vercel/next.js/blob/canary/release.js) - [Commits](vercel/next.js@v14.2.13...v14.2.25) --- updated-dependencies: - dependency-name: next dependency-type: direct:production dependency-group: npm_and_yarn ... Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

Adds a basic Node.js peer with a terminal user interface. Lifts some code from the existing js-peer. Doesn't support DMs or dialing peers directly (yet). Fixes libp2p#214 --------- Co-authored-by: Daniel N <2color@users.noreply.github.com>

* chore: add or force update .github/workflows/stale.yml * chore: add or force update .github/workflows/generated-pr.yml

* add tui ui * add polling of events * clean up peer code * all hooked up * clean up system messages * smarter system messages * add tcp * fix channel handling * drop peers when they hang up * fix listen address is not necessarily an external address * add better logging and peer list * add headless, kademlia, relay, dcutr, webrtc, peer discovery * fix clippy * add tui ui * add polling of events * clean up peer code * all hooked up * clean up system messages * smarter system messages * add tcp * fix channel handling * drop peers when they hang up * fix listen address is not necessarily an external address * add better logging and peer list * add headless, kademlia, relay, dcutr, webrtc, peer discovery * fix clippy Signed-off-by: Dave Grantham <dwg@linuxprogrammer.org>

- Refactored UI code to utilize trio memory channels for asynchronous communication, replacing the previous queue-based approach. - Implemented handling of incoming and outgoing messages using async methods, improving responsiveness and error handling. - Simplified message sending and processing logic, ensuring UI updates are handled safely within the async context.

… Textual; integrated Janus queue for communication between service and TUI.

…top of TUI.

…dule

…ChatRoom

… installation instructions

…ADME

sumanjeet0012 · 2025-07-13T12:30:21Z

@seetadev Ready for review

…debugging

…mpatibility with py peer

…pdate .gitignore

… enhance headless service initialization with strict signing option

… creation

pacrob · 2026-03-03T13:05:47Z

+BOOTSTRAP_PEERS = [
+    "/ip4/139.178.65.157/tcp/4001/p2p/QmQCU2EcMqAqQPR2i9bChDtGNJchTbq5TbXJJ16u19uLTa",
+    "/ip4/139.178.91.71/tcp/4001/p2p/QmNnooDu7bfjPFoTZYxMNLWUQJyrVwtbZg5gBMjTezGAJN",
+    "/ip4/145.40.118.135/tcp/4001/p2p/QmcZf59bWwK5XFi76CZX8cbJ4BhTzzA3gU1ZjYZcYW3dwt"


missing a comma

added comma.

pacrob · 2026-03-03T13:07:50Z

+                                # nursery.start_soon(maintain_connections, self.host)
+
+            except (MultiselectClientError, StreamFailure) as e:
+                logger.log(f"The protocol negotitaion failed: {e}")


My pylance is showing this missing an arg. Looks like logger.log takes both a level and a msg.

Yes, that is correct. I have replaced logger.log with logger.error.

pacrob · 2026-03-03T13:10:54Z

+                port=args.port,
+                connect_addrs=args.connect,
+                strict_signing=strict_signing,
+                seed=args.seed,


We take and pass seed here, but over in HeadlessService the value is never used.

The seed is now handled as follows:

secret = hashlib.sha256(self.seed.encode()).digest() key_pair = create_new_key_pair(seed=secret)

pacrob · 2026-03-03T13:13:19Z

You've removed hello.py, but the top-level README still says to run py-peer with uv run hello.py.

…ssaging, identity handling, and service control.

…store

…configuration in pyproject.toml

…hapes

…nent

seetadev · 2026-03-29T22:32:55Z

@sumanjeet0012 : Hi Sumanjeet. Please ping me and @pacrob once this dapp is fully ready for final merge.

Will collaborate with the maintainers of the repo to see this PR landed.

….seed

…ronment and starting the application

sumanjeet0012 · 2026-04-03T20:07:28Z

You've removed hello.py, but the top-level README still says to run py-peer with uv run hello.py.

Added proper documentation for running py-peer of universal connectivity.

sumanjeet0012 · 2026-04-03T20:08:10Z

@pacrob @seetadev I have made all the required changes.

dependabot bot and others added 20 commits March 27, 2025 17:41

feat: add Node.js peer (libp2p#268)

24e2960

Adds a basic Node.js peer with a terminal user interface. Lifts some code from the existing js-peer. Doesn't support DMs or dialing peers directly (yet). Fixes libp2p#214 --------- Co-authored-by: Daniel N <2color@users.noreply.github.com>

ci: uci/copy-templates (libp2p#271)

b0ef55c

* chore: add or force update .github/workflows/stale.yml * chore: add or force update .github/workflows/generated-pr.yml

feat: added basic cli py-peer

e4666f3

basic TUI structure created

c579c33

feat: add trio-asyncio support for better combatibility

996c6b1

Refactored py-peer architecture: added headless service and TUI using…

f2b4bce

… Textual; integrated Janus queue for communication between service and TUI.

fix: update chat and peers log methods to use write_line

ce986cf

fix: adjust scrollbar size for Log widget

ad9d73e

Removed unused files and refactored UI files

cdd67ab

fix: improve logging configuration for headless and UI modes

82e7340

fix: duplicate message for own peer and fix some overlapping logs on …

73f3530

…top of TUI.

refactor: reorganize imports and simplify message formatting in UI mo…

c0764a4

…dule

Removed some log files

df15661

refactor: remove unused log files and streamline message handling in …

dedf1eb

…ChatRoom

refactor: remove unused development dependencies and system messages

2ea83f0

docs: update README for clarity and structure, enhancing features and…

0167217

… installation instructions

docs: add screenshots and description for Textual TUI Interface in RE…

d5a0ff6

…ADME

sumanjeet0012 added 4 commits July 13, 2025 18:10

docs: update README to clarify multiaddr sharing in Textual UI

81cbcb3

refactor: enhance logging in ChatRoom and HeadlessService for better …

04b7026

…debugging

Disabled peer discovery and added more loggings in go peer to test co…

a851353

…mpatibility with py peer

refactor: enhance logging and compatibility in Go and Python peers; u…

7900d12

…pdate .gitignore

sumanjeet0012 requested a review from a team as a code owner August 25, 2025 17:47

sumanjeet0012 added 4 commits August 26, 2025 11:43

removed strict validation

c2a8303

refactor: update message publishing to use JSON format with nickname;…

19e8005

… enhance headless service initialization with strict signing option

refactor: change key pair generation from Ed25519 to RSA for identity…

d73aaee

… creation

reverted all go peer changes

9687044

sumanjeet0012 added 2 commits February 28, 2026 13:59

feat: implemented file sharing using bitswap

6164d97

fix: correct libp2p repository URL in dependencies

b1e3f95

pacrob reviewed Mar 3, 2026

View reviewed changes

sumanjeet0012 added 14 commits March 3, 2026 23:35

Added REST and WebSocket API endpoints to support peer management, me…

1c29260

…ssaging, identity handling, and service control.

made static peer id and port Number

124f804

feat: added frontend for py-peer

bfacf08

feat: add .gitignore and update API base URL handling in client.ts

f7c2382

feat: implement RAG assistant with API endpoint and integrate vector …

7c21d54

…store

fix: update vector store directory path

da6eb9f

fix: incorrect url for ask endpoint

403c320

Update libp2p dependency to a new commit hash

5a90b47

Update libp2p dependency source in pyproject.toml

b5d54eb

fix: update import path for background_trio_service and add metadata …

53a76e6

…configuration in pyproject.toml

fix: add tornado dependency to pyproject.toml

04b3e98

fix: update README to include Tornado API and React frontend details

9c6988a

docs: enhance API reference with RAG assistant details and response s…

d7979f9

…hapes

fix: update styling and button functionality in LibP2PAssistant compo…

896412a

…nent

seetadev self-requested a review March 30, 2026 21:53

sumanjeet0012 added 4 commits April 2, 2026 21:57

fix: simplify seed handling in HeadlessService by directly using self…

1358337

….seed

fix: add langchain-chroma to installation instructions in README

7932804

fix: update bootstrap peers and improve logging in HeadlessService

d8beefa

docs: update README with instructions for setting up Python peer envi…

5ce7d62

…ronment and starting the application

Merge branch 'main' into py-peer-development

121440b

sumanjeet0012 requested a review from a team as a code owner April 9, 2026 18:25

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat: Implement py-peer of Universal Connectivity dApp#294

feat: Implement py-peer of Universal Connectivity dApp#294
sumanjeet0012 wants to merge 82 commits intolibp2p:py-peer-developmentfrom
sumanjeet0012:py-peer-development

sumanjeet0012 commented Jul 4, 2025 •

edited

Loading

Uh oh!

sumanjeet0012 commented Jul 13, 2025

Uh oh!

pacrob Mar 3, 2026

Uh oh!

sumanjeet0012 Apr 3, 2026

Uh oh!

pacrob Mar 3, 2026

Uh oh!

sumanjeet0012 Apr 3, 2026

Uh oh!

pacrob Mar 3, 2026 •

edited

Loading

Uh oh!

sumanjeet0012 Apr 3, 2026

Uh oh!

pacrob commented Mar 3, 2026 •

edited

Loading

Uh oh!

seetadev commented Mar 29, 2026

Uh oh!

sumanjeet0012 commented Apr 3, 2026 •

edited

Loading

Uh oh!

sumanjeet0012 commented Apr 3, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

11 participants

Conversation

sumanjeet0012 commented Jul 4, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Python Implementation of Universal Connectivity Chat Application

Overview

Related Issue

Implementation Details

Core Features

Technical Stack

Key Components

Usage Examples

Testing

Dependencies

Documentation

Additional Notes

Uh oh!

sumanjeet0012 commented Jul 13, 2025

Uh oh!

pacrob Mar 3, 2026

Choose a reason for hiding this comment

Uh oh!

sumanjeet0012 Apr 3, 2026

Choose a reason for hiding this comment

Uh oh!

pacrob Mar 3, 2026

Choose a reason for hiding this comment

Uh oh!

sumanjeet0012 Apr 3, 2026

Choose a reason for hiding this comment

Uh oh!

pacrob Mar 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

sumanjeet0012 Apr 3, 2026

Choose a reason for hiding this comment

Uh oh!

pacrob commented Mar 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

seetadev commented Mar 29, 2026

Uh oh!

sumanjeet0012 commented Apr 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

sumanjeet0012 commented Apr 3, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

11 participants

sumanjeet0012 commented Jul 4, 2025 •

edited

Loading

pacrob Mar 3, 2026 •

edited

Loading

pacrob commented Mar 3, 2026 •

edited

Loading

sumanjeet0012 commented Apr 3, 2026 •

edited

Loading