Agent Data Shuttle - Example Projects

Agent Data Shuttle (ADS) is an open-source protocol that makes your AI agents truly autonomous.

With ADS, AI agents automatically react to real-world events - no manual triggers or complex workflows required.

ADS creates a universal event bridge between your event sources and AI agents.

This allows seamless, one-to-many event distribution and eliminates redundant webhook registrations.

Key Features:

• Universal Event Bridge: Connect any data source to ADS publishers and instantly distribute events to all subscribed agents.
• One-to-Many Distribution: One publisher can serve unlimited agents, removing the need for redundant webhook setups.
• Agents React Automatically: AI agents respond in real time to relevant events, such as new customer signups, support tickets, payment failures, and system alerts.
• Cross-Team Scalability: Any number of agents can subscribe without extra integrations or engineering effort.
• Built-in Reporting: Track and review each autonomous agent invocation across channels like Slack, Email, and more.
• Universal Compatibility: Works with any AI agent—programmatic, n8n, or custom solutions. SDKs available for TypeScript and Python.
• Fully Open Source: Built by the community, for the community. Contribute, customize, and scale without limits. Licensed under Apache 2.0.

Learn more at agentdatashuttle.knowyours.co.

---

About This Repository

This repository contains a curated collection of example projects demonstrating practical use cases for the Agent Data Shuttle (ADS) protocol.

The examples are designed to help developers, integrators, and researchers understand how to implement, extend, and interact with ADS in real-world scenarios.

Repository Structure

• example-projects/
  Contains standalone projects illustrating different ADS use cases, such as data publishing, subscription, and transformation.
• quickstart/
  Step-by-step guides and minimal working examples for getting started with ADS in various languages (Node.js, Python, etc.).

Example Use Cases

• Node.js Publisher/Subscriber:
  Learn how to publish and consume events using ADS in Node.js.
• Python Publisher/Subscriber:
  See how to implement ADS data flows in Python applications.
• Cross-language Interoperability:
  Explore how ADS enables communication between agents written in different languages.

Getting Started

1. Clone the repository:

   git clone https://github.com/agentdatashuttle/ads-example-projects.git
   cd ads-example-projects

2. Set up the environment:

   For Python based examples, make sure to have an active venv

   • Follow instructions in each example project’s README to install dependencies and execute the project.

3. Run an example:
   Navigate to a project directory (e.g., quickstart/1-nodejs-publisher/) and follow the usage instructions.

Contributing

Contributions are welcome! Please open issues or pull requests to suggest new examples, report bugs, or improve documentation.

You can raise new pull requests with your real world usecases into the example-projects folder

License

This repository is licensed under the Apache License 2.0. See LICENSE for details.