Getting Started with Agenor¶

Get Agenor running in 5 minutes — no code to write yet.

Prerequisites¶

Java 21+
Maven 3.9+

1. Clone and Build¶

git clone https://github.com/mauro-mura/agenor.git
cd agenor
mvn clean install -DskipTests

2. Run Your First Example¶

mvn exec:java -pl agenor-examples \
  -Dexec.mainClass="dev.agenor.examples.PingPongExample"

You should see two agents exchanging messages in the console. That's the runtime up and running.

3. Write One Yourself¶

Running someone else's example only shows you that it works. The next fifteen minutes are the ones that matter: Your First Agent — two agents, one asking and one answering, six concepts, every line written by you.

mvn exec:java -pl agenor-examples   -Dexec.mainClass="dev.agenor.examples.QuickStartExample"

4. Try More Examples¶

# Cyclic behavior + topic pub/sub
mvn exec:java -pl agenor-examples \
  -Dexec.mainClass="dev.agenor.examples.WeatherStationExample"

# FSM + parallel validators (production-style orchestration)
mvn exec:java -pl agenor-examples \
  -Dexec.mainClass="dev.agenor.examples.ecommerce.ECommerceApplication"

# LLM multi-agent (requires OPENAI_API_KEY env var)
mvn exec:java -pl agenor-examples \
  -Dexec.mainClass="dev.agenor.examples.llm.LLMDirectMessagingExample"

The full learning path (Level 0 → Level 5) is in agenor-examples/README.md.

5. Add Agenor to Your Project¶

Until Agenor is published to Maven Central, run mvn install locally first (step 1 above).

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>dev.agenor</groupId>
            <artifactId>agenor-bom</artifactId>
            <version>0.33.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

<dependencies>
    <dependency>
        <groupId>dev.agenor</groupId>
        <artifactId>agenor-runtime</artifactId>
    </dependency>
</dependencies>

agenor-runtime alone gives you ONE_SHOT and CYCLIC. FSM, the composites and Human-in-the-Loop behaviors require an extra agenor-runtime-ext dependency (ADR-027) — see the Behaviors Overview.

Next Steps¶

I want to…	Go to
Write my first agent	Your First Agent
Go deeper on agent structure	Agent Development Guide
Understand the module structure	Architecture Guide
Browse all behavior types	Behaviors Overview
Integrate an LLM provider	LLM Integration Guide
Configure Agenor via YAML	Configuration Guide