Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions docs/apis/api_main.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,4 +4,11 @@
---
maxdepth: 3
---
llm_agent
module_llm
memory
reasoning
tools
recording
parallel_stepping
```
23 changes: 19 additions & 4 deletions docs/examples.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,27 @@
# Examples

# Mesa-LLM Core Examples
The examples folder contains a curated set of classic llm-agent-based models implemented using Mesa-LLM. These core examples are maintained by the Mesa-LLM development team and serve as both demonstrations of Mesa-LLM's capabilities and starting points for your own models.
The examples folder contains LLM agent-based models implemented using Mesa-LLM. They serve as demonstrations of Mesa-LLM's capabilities and starting points for your own models.

This folder contains both basic and advanced examples that demonstrate different aspects of Mesa-LLM.

### Epstein Civil Violence Model
## Epstein Civil Violence Model

Joshua Epstein's [model](https://www.pnas.org/doi/10.1073/pnas.092080199) of how a decentralized uprising can be suppressed or reach a critical mass of support.

### Negotiation Model
**Location:** [examples/epstein_civil_violence](https://github.com/projectmesa/mesa-llm/tree/main/examples/epstein_civil_violence)

This example demonstrates:
- Agent decision-making based on social dynamics
- LLM-powered agent reasoning in conflict scenarios
- Integration of multiple agent types with different behaviors

## Negotiation Model

Implementation of a negotiation model where two types of agents (buyer and seller) negotiate over a product.

**Location:** [examples/negotiation](https://github.com/projectmesa/mesa-llm/tree/main/examples/negotiation)

This example demonstrates:
- Agent-to-agent communication
- LLM-based negotiation strategies
- Dynamic pricing and offer-counteroffer mechanisms
1 change: 1 addition & 0 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -66,6 +66,7 @@ hidden: true
---
Introduction <self>
API Documentation <apis/api_main>
Examples <examples>
```

## Indices and tables
Expand Down