Skip to content

create README with links. #43

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

create README with links. #43

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
85 changes: 85 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,85 @@
# AGNTCY: Agentic Applications Collection

Welcome to the AGNTCY's Agentic Applications Collection! This repository contains a diverse set of applications built using agent-based architectures and the Agent Connect Protocol (ACP). Each application demonstrates different aspects of agent-based computing and AI integration.

## 🚀 Projects Overview

This repository contains several independent agentic applications:

1. **Weather Vibes AGP** - A weather-based agent application demonstrating the Agent Connect Protocol implementation
2. **Remote Agent AGP** - A framework for managing and interacting with remote agents
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  1. A chatbot that uses AGP to connect two agents.

3. **Network of Assistants** - A collaborative network of AI assistants working together
4. **Marketing Campaign** - An agent-based marketing campaign management system
5. **Mail Composer** - An intelligent email composition assistant
6. **Email Reviewer** - An AI-powered email review and analysis tool

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AGP

  1. The Agent Gateway Protocol is a message bus protocol that built on top of gRPC/HTTP2/3 designed for multi-agent
    communication. AGP supports diverse messaging patterns out of the box (GitHub -agntcy/agp: Agent Gateway
    Protocol). Its data plane uses channel-based addressing and intelligent routing: messages can be delivered via multicast
    (broadcast to many agents) or anycast (one of many), with content-based routing rules to direct messages by
    their metadata or content

  2. Security is a first-class facet of AGP. It uses Message Layer Security (MLS) to provide quantum-safe end-to-end
    encryption for groups of agents (Security Layer — AGNTCY Collective v0.1.1 documentation). Every message exchanged via AGP can be encrypted such that only the intended agents (group members) can decrypt it – not even intermediate servers or gateways can read the plaintext. This aligns with a zero-trust philosophy: even if the infrastructure carrying the
    messages is untrusted, the content remains confidential and authenticated. (Security Layer — AGNTCY Collective
    v0.1.1 documentation)

  3. AGP messaging constructs are designed to facilitate higher-level coordination patterns. Because it supports group
    messaging (one-to-many multicast) and anycast, an agent could broadcast a query to a group and gather multiple
    responses through the secure channel. This makes it easier to implement patterns like voting (where each agent in a group returns an answer) or leader election and consensus across agents, using the messaging.

  4. A core strength of AGP is dynamic group management. It implements secure group communication using MLS (Message Layer Security), which inherently supports dynamic membership – agents can be added to or removed from a conversation group with automatic key updates and state management (Security Layer
    — AGNTCY Collective v0.1.1 documentation)

## 🤖 Agent Connect Protocol (ACP)

The [Agent Connect Protocol (ACP)](https://agntcy.org/) is a standardized protocol that enables seamless communication between different AI agents, regardless of their implementation or location. ACP provides:

- **Standardized Communication**: A common language for agent interactions
- **Flexible Authentication**: Support for various authentication schemes
- **Multiple Execution Modes**: Synchronous, asynchronous, and streaming capabilities
- **Configuration Management**: Standardized ways to configure and manage agents
- **Error Handling**: Comprehensive error definitions and handling mechanisms
- **Schema Definitions**: Clear specifications for input, output, and configuration formats

Key ACP Features:
- **Agent Discovery**: Find and connect with available agents
- **Thread Management**: Handle conversational state and context
- **Interrupt Handling**: Support for agent interruptions and resumptions
- **Streaming Support**: Real-time partial results delivery
- **Cross-Framework Compatibility**: Enables agents built with different frameworks to communicate

For more detailed information about ACP, visit the [official documentation](https://docs.agntcy.org/).

## 📚 Documentation

Each project contains its own detailed documentation and README. Please refer to the individual project directories for specific setup and usage instructions.

## 🛠️ Technology Stack

- **Agent Connect Protocol (ACP)** - Standard interface for agent communication
- [ACP Specification](https://docs.agntcy.org/pages/connect.html)
- [Open Agentic Schema Framework (OASF)](https://docs.agntcy.org/pages/oasf.html)
- **Simple Agent Framework** - Base framework for building agentic applications
- **Various AI/ML Models** - Integrated across different applications
- **Modern Web Technologies** - For frontend interfaces where applicable

## 📋 Repository Structure

```
.
├── weather_vibes_agp/ # Weather-based agent application
├── remote_agent_agp/ # Remote agent management framework
├── network_of_assistants/ # Collaborative AI assistant network
├── marketing-campaign/ # Marketing campaign management
├── mailcomposer/ # Email composition assistant
├── email_reviewer/ # Email analysis tool
└── .github/ # GitHub configuration and workflows
```

## 🤝 Contributing

We welcome contributions! Please read our [Contributing Guidelines](CONTRIBUTING.md) for details on our code of conduct and the process for submitting pull requests.

## 📜 License

This project is licensed under the terms specified in the [LICENSE](LICENSE) file.

## 🔒 Security

Security is important to us. Please review our [Security Policy](SECURITY.md) for information on reporting vulnerabilities.

## 👥 Maintainers

The project maintainers are listed in [MAINTAINERS.md](MAINTAINERS.md).

## 🙏 Acknowledgments

- The [Internet of Agents (IoA)](https://docs.agntcy.org/pages/ioa.html) community for their support and collaboration
- All contributors who have helped shape these projects

## 📞 Support

For support, please open an issue in the respective project's repository or contact the maintainers listed in [MAINTAINERS.md](MAINTAINERS.md).
Loading