Agent-Kernel is a user-friendly multi-agent system development framework, which is designed to powerfully enable large-scale social simulation. This offers the opportunity to Explore the Scaling Law of Collective Intelligence.
Agent-Kernel supports:
-
dynamic addition and removal of LLMs-based agents at runtime;
-
unlimited scalability of agents;
-
real-time intervention during the simulation process;
-
trustworthy verification of agent behaviors and large model outputs;
-
code reuse across different simulation scenarios.
Agent-Kernel has been successfully applied to several complex social simulation scenarios:
Simulating the famous "Universe 25" sociological experiment to explore the relationships between population density, social structure, and behavioral anomalies.
Constructing a high-fidelity simulation of the campus environment to study pedestrian flow dynamics, resource allocation, and social interaction patterns.
- ✨ Highlights
- 🎬 Showcase
- 🎯 Core Advantages: Why Choose Agent-Kernel?
- 🏛️ Architecture and Design
- 🚀 Quick Start
- 📂 Project Structure
- 🎓 Citation
- 🤝 Contributors
- 📜 License
Agent-Kernel offers four core advantages for social simulation, making it stand out in the study of multi-agent systems:
Agent-Kernel supports adding/removing agents, changing environments, and modifying behaviors at runtime. This enables simulations to naturally reflect population flow, environmental shifts, and evolving behavioral patterns.
With the Controller module, Agent-Kernel allows real-time adjustments to parameters or events during simulation. This makes it easy to test and validate complex sociological hypotheses.
Agent-Kernel employs a strict system-level verification mechanism, validating every agent action. This ensures that simulation behaviors follow physical and social rules, maintaining scientific rigor.
Agent-Kernel uses a standardized, plugin-based modular design. Codes can be reused across scenarios, significantly accelerating research iteration.
The Agent-Kernel framework adopts a modular microkernel architecture, with a core system—composed of the Agent, Environment, Action, Controller, and System modules—and multiple plugins. The core manages plugin registration, behavior verification, asynchronous communication, and other core responsibilities, while plugins provide the specialized functions for social simulation, as shown in the diagram below:
To realize the core design goals of the Agent-Kernel framework, we made a series of deliberate software design decisions, as illustrated in the diagram below:
Python ≥ 3.11
You can choose either standalone or distributed package based on your needs.
pip install agentkernel-standalone👉 For detailed usage and examples, see the Standalone README.
pip install agentkernel-distributedNote: The distributed package depends on Ray and will install it automatically.
👉 For detailed usage and examples, see the Distributed README.
Both agentkernel-standalone and agentkernel-distributed support optional dependencies for web services and storage solutions. You can install them as needed.
web→ Installsaiohttp,fastapi,uvicornstorages→ Installsasyncpg,pymilvus,redisall→ Installs bothwebandstorages
To install a package with these extras, use square brackets []. For example:
# Install the standalone package with web features
pip install "agentkernel-standalone[web]"
# Install the distributed package with storage features
pip install "agentkernel-distributed[storages]"
# Install the distributed package with all optional features
pip install "agentkernel-distributed[all]"Society-Panel is a web-based control panel to help you configure, deploy, and monitor your simulations visually.
-
Launch the panel: Use the provided startup scripts to launch the entire application stack (backend + UI). These scripts will automatically check for and install all required dependencies, so no manual environment setup is needed.
-
On Linux/macOS:
# Grant execution permission (first time only) chmod +x scripts/start_society_panel.sh ./scripts/start_society_panel.sh -
On Windows:
scripts\start_society_panel.bat
-
-
Access the UI: Once the script confirms that the services are running, open your browser and navigate to:
http://localhost:5174
From the panel, you can upload custom code packages, edit configuration files through a graphical interface, and control the simulation lifecycle. To shut down the panel and all related services, simply press Ctrl+C in the terminal where you ran the script.
MAS/
├── packages/
│ ├── agentkernel-distributed/ # Distributed version (installs Ray automatically)
│ └── agentkernel-standalone/ # Local single-machine version
│
├── examples/
│ ├── distributed_test/ # Example for the distributed version (Ray)
│ └── standalone_test/ # Example for the local standalone version
│
├── society-panel/
│ ├── backend/ # FastAPI backend service
│ └── frontend/ # Vue 3 + Vite frontend
│
└── README.md
If you use Agent-Kernel in your research, please consider citing our paper:
@misc{mao2025agentkernelmicrokernelmultiagentframework,
title={Agent-Kernel: A MicroKernel Multi-Agent System Framework for Adaptive Social Simulation Powered by LLMs},
author={Yuren Mao and Peigen Liu and Xinjian Wang and Rui Ding and Jing Miao and Hui Zou and Mingjie Qi and Wanxiang Luo and Longbin Lai and Kai Wang and Zhengping Qian and Peilun Yang and Yunjun Gao and Ying Zhang},
year={2025},
eprint={2512.01610},
archivePrefix={arXiv},
primaryClass={cs.MA},
url={https://arxiv.org/abs/2512.01610},
}
Thanks to all the developers who have contributed to Agent-Kernel:
We also welcome you to become one of our contributors via Pull Requests!
This project is licensed under the Apache 2.0.
