mesa / mesa/mesa-llm

doc: Add Migration Guide from Mesa, Mesa-geo to Mesa-LLM

Open
#324 3 comments 0 reactions 0 assignees View on GitHub
Dominant language
Python
Stars
73
Forks
89
Avg merge
14d 58m
Merged PRs (30d)
2

Description

## Description

Add a comprehensive migration guide for users moving from **Mesa** or **Mesa-Geo** to **Mesa-LLM**.

The guide should provide a practical, step-by-step migration path and explain how existing Mesa and Mesa-Geo models can be adapted to work with LLM-powered agents in Mesa-LLM.

### Scope

The migration guide should cover:

* Key differences between **Mesa, Mesa-Geo, and Mesa-LLM**
* Mapping common Mesa concepts and workflows to Mesa-LLM
* Migrating existing Mesa models to Mesa-LLM
* Migrating **Mesa-Geo** models and geospatial workflows to Mesa-LLM
* Adapting agents to use LLM-powered reasoning and memory
* Configuring LLM providers and models
* Common migration issues and troubleshooting
* Links to relevant Mesa-LLM tutorials and documentation

### Expected Outcome

A clear, beginner-friendly migration guide that helps existing **Mesa and Mesa-Geo users** understand what changes are required to adopt Mesa-LLM and migrate their existing models and workflows.

Contributor guide

Open the contributing guide

Research direction

Start by reviewing the existing Mesa, Mesa-Geo, and Mesa-LLM tutorials and documentation. Compare their concepts, model workflows, geospatial workflows, agent configuration, and provider setup, then document a step-by-step migration path with troubleshooting and links. Done means Mesa and Mesa-Geo users can understand the required changes and adapt their workflows to Mesa-LLM.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
ai, documentation
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.