MultiAgentPuzzleSolver provides a modular environment where independent AI agents work together to solve puzzles such as sliding tiles, Rubik’s Cube, and logic grids. Agents share state information, negotiate subtask assignments, and apply diverse heuristics to explore the solution space more effectively than single-agent approaches. Developers can plug in new agent behaviors, customize communication protocols, and add novel puzzle definitions. The framework includes tools for real-time visualization of agent interactions, performance metrics collection, and experiment scripting. It supports Python 3.8+, standard libraries, and popular ML toolkits for seamless integration into research projects.