Skip to main content

​
What is The Mesh?

The Mesh is TAHO’s self-forming peer-to-peer network that connects nodes automatically for distributed computing. When you start TAHO, your node joins The Mesh and can immediately discover and communicate with other nodes—no configuration required. The Mesh handles:
  • Automatic peer discovery - Find nodes on your local network and across the internet
  • Resilient connections - Maintain connectivity as nodes join and leave
  • Content routing - Efficiently locate and transfer content across the network
  • Component coordination - Enable distributed AI/ML workloads and service invocations

​
Peer Discovery

The Mesh uses multiple discovery mechanisms to find peers:

​
Local Network Discovery

Nodes on the same local network (subnet) automatically discover each other through multicast announcements. This enables zero-configuration networking for development and edge deployments. 
# Start TAHO - automatically discovers local peers
taho --daemon

​
Remote Peer Discovery

For nodes across the internet, The Mesh uses rendezvous points—well-known bootstrap nodes that help peers find each other. You can configure bootstrap peers by setting environment variables or editing your configuration file: 
# Configure bootstrap peers via environment variable
export TAHO__FABRIC__BOOTSTRAP="/ip4/203.0.113.1/tcp/4001/p2p/12D3KooW..."

# Or edit your config file (see location with: taho config)
# Add bootstrap peers to the [mesh] section

​
Network Transports

The Mesh supports multiple transport protocols for flexibility across different environments:

​
Native Nodes

Native TAHO nodes (Linux, macOS) use:
  • QUIC - High-performance UDP-based transport optimized for modern networks
  • WebSocket - TCP-based transport for compatibility with browser nodes and restrictive firewalls
Both transports run simultaneously, allowing native nodes to connect to any peer type.

​
Browser Nodes

Browser-based nodes run entirely in your web browser using WebAssembly. They connect via WebSocket transport, enabling distributed computing without installing software.
Browser nodes are perfect for lightweight participation in The Mesh—contribute compute resources or access distributed services directly from your browser.

​
Content Distribution

The Mesh integrates tightly with TAHO’s Content Exchange system for efficient content distribution:

​
Content Announcements

When you publish content, your node announces its availability to The Mesh via a gossip protocol. Other nodes subscribe to these announcements and maintain an index of content holders. 
# Publish content - automatically announced to The Mesh
taho publish ./model.onnx
# Output: abc123def456...

# Content availability is gossiped across the network
# Other nodes now know you have this content

​
Content Fetching

When a node needs content, The Mesh automatically locates holders and fetches it:
  1. Discovery - Query The Mesh for nodes holding the content
  2. Selection - Choose optimal peer based on latency and availability
  3. Transfer - Fetch content directly from the holder
  4. Verification - Validate content integrity via content ID hash
This process happens automatically when your application requests content by content ID through the Content Exchange API.

​
Distributed Services

The Mesh enables nodes to invoke services and components on remote nodes, creating a distributed compute network.

​
Port Invocations

Components expose service functions that can be invoked remotely. The Mesh routes these invocations to the appropriate nodes and returns results.

​
Event Publishing

Nodes can publish events to topics, with The Mesh delivering them to all subscribers. This enables reactive distributed systems where components respond to events across the network.

​
Component Deployment

The Mesh can coordinate component deployment—streaming WebAssembly components from repositories and deploying them across multiple nodes simultaneously.

​
Network Resilience

The Mesh is designed for reliability in dynamic network environments:

​
Fault Tolerance

  • Redundant connections - Maintains multiple peer connections for reliability
  • Automatic reconnection - Re-establishes dropped connections without manual intervention
  • Content redundancy - Content remains available as long as any holder is online

​
Mesh Topology

The Mesh forms a mesh network where nodes connect to multiple peers. This provides multiple paths for content and messages, ensuring availability even if individual nodes fail.

​
Graceful Degradation

When network conditions deteriorate:
  • Adjusts heartbeat intervals to maintain connectivity
  • Falls back to alternative transports if needed
  • Continues operating with reduced peer sets

​
Mesh Use Cases

​
Distributed AI/ML Inference

Run large models by distributing inference workload across multiple nodes:

​
Content Distribution Networks

Create peer-to-peer content distribution for large files like ML models or datasets: 
# Publisher node
taho publish ./dataset.tar.gz
# Content ID: ca_blake3_xyz789...

# Consumer nodes automatically fetch when they request the content
# through the Content Exchange API - no manual fetch command needed

​
Next Steps