Back to Home

Troubleshooting Guide

Common issues and solutions for AgentsMCP users

Installation Issues

Issue: Package installation fails

Error messages during devtools::install_github()

Solution:
  1. Update R to version 4.0.0 or higher
  2. Install/update devtools: install.packages("devtools")
  3. Install dependencies manually if needed
  4. Check internet connection for GitHub access

Memory and Performance Issues

Issue: Out of memory errors with large simulations

R runs out of memory with high n_agents or n_steps

Solution:
  • Reduce n_agents (try 100-500 for testing)
  • Reduce n_steps (try 50-100 for testing)
  • Increase R memory limit: memory.limit(size = 8000) (Windows)
  • Close other applications to free memory

Data Loading Issues

Issue: Cannot load market data

Yahoo Finance connection fails or symbols not found

Solution:
  • Check internet connection
  • Verify stock symbols are valid (e.g., "AAPL", "MSFT")
  • Use synthetic data for testing: generate_synthetic_data()
  • Try fewer symbols or different date ranges

Visualization Issues

Issue: Plots not displaying or saving

Visualization functions fail or produce empty plots

Solution:
  • Ensure ggplot2 and dependencies are installed
  • Check that results object is complete
  • Try individual plot functions first
  • Specify output directory for saving plots

Network Analysis Issues

Issue: Network evolution fails

Error in network analysis or evolution functions

Solution:
  • Check igraph package is properly installed
  • Ensure agent decisions are valid numeric values
  • Reduce network evolution parameters for stability
  • Start with smaller networks (fewer agents)

Getting Additional Help

If these solutions don't resolve your issue:

System Information

When reporting issues, please include: