Apache Flink Agents Demos

A collection of demo projects and examples for Apache Flink Agents — an Agentic AI framework based on Apache Flink.

About

This repository hosts community-contributed demo projects that showcase various use cases and capabilities of Apache Flink Agents. Anyone is welcome to contribute their demo code — whether it's a simple getting-started example, an advanced multi-agent workflow, or an integration with external systems.

Repository Structure

Each demo lives in its own top-level directory:

flink-agents-demos/
├── demo-a/          # Each demo is a self-contained project
│   ├── README.md    # Description, setup instructions, and usage
│   └── ...
├── demo-b/
│   ├── README.md
│   └── ...
└── ...

Contributing a Demo

We welcome contributions from everyone! To add your demo:

Fork this repository and create a new branch.
Create a new directory at the root level with a descriptive name for your demo (e.g., chatbot-with-tools/, multi-agent-rag/).
Include a README.md in your demo directory that covers:
- What the demo does
- Prerequisites
- How to set up and run it
- Expected output or screenshots (if applicable)
Keep it self-contained — each demo should be independently runnable without dependencies on other demos in this repo.
Submit a Pull Request with a clear description of your demo.

Guidelines

Make sure your demo works with a released or recent version of Flink Agents.
Use clear, readable code with appropriate comments.
Avoid committing secrets, API keys, or other sensitive information. Use environment variables or configuration files (added to .gitignore) instead.
You may use any programming language supported by Flink Agents (Java, Python, etc.).

Community

Slack: Join the Apache Flink Slack workspace and find us in #flink-agents-user and #flink-agents-dev.
Flink Agents Repository: https://github.com/apache/flink-agents

License

This project is licensed under the Apache License 2.0.

Demo projects and examples for Apache Flink Agents