🔧 Prerequisites

Java Runtime

Version: Java 11 or higher

Recommended: OpenJDK 17 LTS

java -version

Event Broker

Supported: Apache Kafka, NATS, Solace PubSub+

Minimum: Kafka 2.8+ or NATS 2.9+

System Resources

Memory: 2GB RAM minimum, 4GB recommended

Storage: 1GB available disk space

Network: Outbound connectivity for dependencies

⚡ Installation Methods

📋 Maven Dependency

Add AMCP to your Maven project:

<dependency>
    <groupId>org.amcp</groupId>
    <artifactId>amcp-core</artifactId>
    <version>1.5.0</version>
</dependency>

🐘 Gradle Dependency

Add AMCP to your Gradle project:

implementation 'org.amcp:amcp-core:1.5.0'

📥 Direct Download

Download the latest AMCP JAR:

wget https://github.com/agentmeshcommunicationprotocol/amcpcore.github.io/releases/download/v1.5.0/amcp-core-1.5.0.jar

🐳 Docker Setup

Run AMCP with Docker for quick setup:

Docker Compose

version: '3.8'
services:
  amcp-core:
    image: amcp/core:1.5.0
    ports:
      - "8080:8080"
    environment:
      - AMCP_BROKER_URL=kafka:9092
      - AMCP_LOG_LEVEL=INFO
    depends_on:
      - kafka
  
  kafka:
    image: confluentinc/cp-kafka:latest
    environment:
      KAFKA_ZOOKEEPER_CONNECT: zookeeper:2181
      KAFKA_ADVERTISED_LISTENERS: PLAINTEXT://kafka:9092
    depends_on:
      - zookeeper
  
  zookeeper:
    image: confluentinc/cp-zookeeper:latest
    environment:
      ZOOKEEPER_CLIENT_PORT: 2181

Start Services

docker-compose up -d

✅ Installation Verification

1. Check AMCP Status

curl http://localhost:8080/health

Expected response: {"status": "UP", "version": "1.5.0"}

2. Test Agent Creation

curl -X POST http://localhost:8080/agents \
  -H "Content-Type: application/json" \
  -d '{"type": "TestAgent", "id": "test-001"}'

3. Verify Event Mesh

curl http://localhost:8080/mesh/status

🔍 Troubleshooting

Connection Issues

Problem: Cannot connect to event broker

Solution: Verify broker URL and network connectivity

telnet kafka-host 9092

Memory Issues

Problem: OutOfMemoryError during startup

Solution: Increase JVM heap size

java -Xmx4g -jar amcp-core-1.5.0.jar

Port Conflicts

Problem: Port 8080 already in use

Solution: Change AMCP port

java -Damcp.port=8081 -jar amcp-core-1.5.0.jar

📦 AMCP Installation Guide