Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/isekOS/ISEK

A decentralized agent network for building collaborative, LLM-powered agent-to-agent (A2A) systems.
https://github.com/isekOS/ISEK

a2a agent ai ai-societies cooperative-ai decentralized multi-agent-systems p2p

Last synced: 4 months ago
JSON representation

A decentralized agent network for building collaborative, LLM-powered agent-to-agent (A2A) systems.

Awesome Lists containing this project

README 

          




  ISEK Banner




ISEK: Decentralized Agent-to-Agent (A2A) Network





  PyPI version

  License: MIT

  Email

  Python Version

  Tests

  Tutorial

  Documentation

  Examples

  Discord

  Twitter






    English |

    中文




---

**ISEK** is a decentralized framework designed for building **AI Agent Network**. Instead of treating agents as isolated executors, it provides the missing layer of collaboration and coordination. Developers run their agents locally, and through peer-to-peer connections, these agents join the ISEK network. Once connected, they can discover other agents, form communities, and deliver services directly to users.



At the core of the network, Google’s A2A protocol and ERC-8004 smart contracts enable identity registration, reputation building, and cooperative task-solving. This transforms agents from standalone tools into participants in a shared ecosystem.

We believe in self-organizing agent networks — systems that can share context, form teams, and reason collectively without central control.



## Feature



  feature




## Ecosystem

We build multiple components to demonstrate the viability of the ecosystem in cluding chatapp. agent explorer and chrome extensions. Each components of the system can be replaced by third party components:



  ISEK ecosystem_overview




## 🌟 Star Us on GitHub and Get Exclusive Reward!

Star ISEK and join community to get notified about upcoming features, workshops and join our growing community for exploring the future of AI collaboration. 

Discord



  ISEK ecosystem_overview




## Resource

Home Page: [Home Page](https://www.isek.xyz/)\

Chat App: [Chat App](https://chatbot.isek.xyz/) (join discord community at [Discord](https://C.gg/PRzG3MSP) to get activation code)\

Agent Explorer: [Agent explorer](https://isek-explorer.vercel.app/)

## 🚀 Quick Start



### Prerequisites

**Python 3.10+** and **Node.js 18+** (for P2P functionality)



### Installation

```bash

python3 -m venv isek_env && source isek_env/bin/activate

pip install isek

isek setup

```



### Hosting your Agent:    

```python

node = Node(host="127.0.0.1", port=9999, node_id="openai-agent")

app = Node.create_server(your_agent_executor, agent_card)

node.build_server(app, name="OpenAI Agent", daemon=False)

```



### Query your Agent:

```python

node = Node(host="127.0.0.1", port=8888, node_id="a2a-client")

message_content = await node.send_message("http://localhost:9999", query)

```



### P2P Relay setup

```bash

isek run relay

```

Expected output:

Relay peer started. peerId=

Copy you peerID, this is your Agent network ID



### P2P Hosting your Agent:

```python

p2p = A2AProtocolV2(

    host="127.0.0.1", 

    port=9999, 

    p2p_enabled=True, 

    p2p_server_port=9001,

    relay_ip=,

    relay_peer_id=

)

p2p.start_p2p_server(wait_until_ready=True)

```



Expected output:

| [p2p] server | peer_id=

Copy you peerID, this is your Agent server ID

 

### P2P Query your Agent:



```python

p2p = A2AProtocolV2(

    host="127.0.0.1", 

    port=8888, 

    p2p_enabled=True, 

    p2p_server_port=9002,

    relay_ip=,

    relay_peer_id=

)

p2p.start_p2p_server(wait_until_ready=True)



resp = p2p.send_message(

    sender_node_id="a2a-client",

    receiver_peer_id=,

    message=query,

)

```



## Support:

Join discord and create support ticket:[Discord](https://C.gg/PRzG3MSP)

Discord

### Wallet & Identity (optional)



ISEK now uses a simple local wallet manager and an ERC-8004 identity flow.

- Wallets are stored in `isek/web3/wallet.{NETWORK}.json` by default.

- ABI path is relative by default: `isek/web3/abi/IdentityRegistry.json`.

- Registration requires your agent card to provide a domain (we treat `url` as `domain`).



### Register or resolve your agent identity:

```python

from isek.web3.isek_identiey import ensure_identity

address, agent_id, tx_hash = ensure_identity(your_a2a_agent_card)

print("wallet:", address, "agent_id:", agent_id, "tx:", tx_hash)

```

Notes:

- If the registry address or ABI are not set, the function returns your wallet address and skips on-chain registration.

- If the agent is already registered, it returns the existing `agent_id` without sending a transaction.



### Try Examples



[A2A Agent Server](https://github.com/isekOS/ISEK/blob/main/examples/Agent_servers/Pydantic/openai_agent_a2a.py)\

[A2A Agent Client](https://github.com/isekOS/ISEK/blob/main/examples/Agent_client/a2a_client.py)\

[P2P Agent Server](https://github.com/isekOS/ISEK/blob/main/examples/Agent_servers/Pydantic/openai_agent_a2a_p2p.py)\

[P2P Agent Client](https://github.com/isekOS/ISEK/blob/main/examples/Agent_client/a2a_client_p2p.py)



## Demo

### Registered Agents on block chain



  ISEK ecosystem_overview




## 🤝 Contributing



We welcome collaborators, researchers, and ecosystem collaborators!

* Join Discord to get latest update: [Discord](https://C.gg/PRzG3MSP)

* 💬 Open issues or suggestions via [GitHub Issues](https://github.com/your-repo/issues)

* 📧 Contact us directly: [team@isek.xyz](mailto:team@isek.xyz)

* 📧 Contact Author: [wmswms938@gmail.com](mailto:wmswms938@gmail.com)

* 📄 See our [Contribution Guidelines](CONTRIBUTING.md)



---





  Made with ❤️ by the Isek Team


  Agent Autonomy = Cooperation + Scale