🐳 flux0-docker-example

Example repo showing how to deploy Flux0 agents using Docker

This repository demonstrates how to package and run your custom Flux0 agents in a Docker container. Flux0 is an open framework for building AI-powered apps with multi-agent support, session management, real-time streaming, and LLM-agnostic execution.

📆 What's Inside?

A simple Dockerfile to:

• Start from the official flux0 base image
• Install any additional Python dependencies (e.g., LangChain)
• Copy your agent code into the container

🚀 How to Build and Run

The agent code lives inside the ./modules/my_agent directory and implements the required Flux0 agent interface.

To build and run the container:

docker build -t my-flux0 .
docker run --rm \
  -e FLUX0_MODULES=my_agent \
  -e OPENAI_API_KEY=your-openai-key \
  -p 8080:8080 \
  my-flux0

🌐 Environment Variables

• FLUX0_MODULES=my_agent: The module name of your agent (relative to ./modules/)
• OPENAI_API_KEY=...: Your OpenAI API key (required if your agent uses OpenAI models)

🧠 Where to Put Your Agent

Your agent should be placed inside the modules folder:

./modules/my_agent/

Inside that folder, make sure you define your agent and register it using Flux0's expected interface.

📚 Learn More

• Flux0 GitHub Repository

---

Made with ❤️ by the Flux0 community