Readme
🤖 Protopolis
A Rust-based AI multi-agent simulation framework (using Ollama)
Protopolis is a project that allows you to create and simulate interactions between AI agents in a colorful terminal environment. Agents can communicate with each other and with the user according to different states and energy levels.
⚠️ Warning: This project is a work in progress (WIP) and will have frequent updates that may break various features.
📋 Features
🧠 Agent Simulation with different states (Idle, Thinking, Speaking)
💬 Messaging System between agents and with the user
🌈 Colorful Terminal Interface for better visualization
⚡ Energy Management for agents
🔄 Simple Commands to control the simulation
🛠️ Installation
⚠️ Note: Make sure to have Ollama installed with the llama3. 2 model before continuing.
git clone https://github.com/LightInn/protopolis
cd protopolis
cargo build -- release
🎮 Usage
To start the simulation:
cargo run -- release
Available Commands
start - Start the simulation
pause - Pause the simulation
resume - Resume the simulation
stop - Stop the simulation
exit - Exit the application
topic < subject> - Set a new discussion topic
msg < agent> < message> - Send a message to a specific agent
🏗️ Architecture
The project is built around several key components:
Agents - Entities with states and behaviors
Messaging System - Asynchronous communication between agents
User Interface - Colorful display in the terminal
Simulation - Orchestration of interactions
🗺️ Roadmap
🤝 Contribution
Contributions are welcome! Feel free to open an issue or a pull request.
📚 Inspired By
TyniTroupe - LLM-powered multiagent persona simulation
🔌 Powered By
Ollama - Local LLM runner
License
MIT © 2025 Breval LE FLOCH