Documentation
Waiide
🚀 CalliopeAI Web AI IDE - Quick Start Guide

🚀 CalliopeAI Web AI IDE - Quick Start Guide

Calliope Integration: This component is integrated into the Calliope AI platform. Some features and configurations may differ from the upstream project.

Welcome to CalliopeAI Web AI IDE (WAIIDE)! This guide will get you up and running in minutes.

Prerequisites

  • Docker 20.10+ and Docker Compose 2.0+
  • Git with submodule support
  • 8GB RAM minimum (16GB recommended)
  • 20GB free disk space

🏃‍♂️ Quick Start (5 minutes)

1. Clone the Repository 

git clone --recursive https://github.com/CalliopeAI/waiide.git
cd waiide

2. Initialize and Build 

# Make build script executable (first time only)
chmod +x build.sh

# Initialize submodules
./build.sh init

# Build the Docker image
./build.sh build

3. Start the IDE

For development:

./build.sh dev

For production with SSL:

./build.sh prod

4. Access CalliopeAI IDE

  • Development: http://localhost:8070 (default port)
  • Production: https://localhost

🎨 Features at a Glance

Pergamon Theme

Your IDE comes pre-configured with our beautiful Pergamon theme:

  • Dark mode for comfortable night coding
  • Light mode for daytime work
  • Optimized color scheme for reduced eye strain

AI Toolkit

The WAIIDE AI Toolkit is pre-installed and configured:

  • WAIIDE completion
  • Intelligent suggestions
  • AI-powered refactoring

📝 Common Commands 

# View logs
./build.sh logs

# Stop the IDE
./build.sh down

# Restart the IDE
./build.sh restart

# Enter container shell
./build.sh shell

# Update submodules
./build.sh update

# Clean everything
./build.sh clean

🔧 Configuration

Change Port

Edit compose.yml:

ports:
  - "YOUR_PORT:8070"  # Default JUPYTERHUB_PORT

Or use environment variable override:

environment:
  - PORT=8080  # Override to port 8080
ports:
  - "8080:8080"

Add Extensions

  1. Place extension in extensions/ directory
  2. Update Dockerfile to include it
  3. Rebuild: ./build.sh build

Custom Theme

  1. Edit files in calliope-theme/themes/
  2. Rebuild the container

🐛 Troubleshooting

Port Already in Use 

# Check default port 8070
sudo lsof -i :8070  # Find what's using port 8070

# Or check port 8080 if using override
sudo lsof -i :8080  # Find what's using port 8080

# Change port in compose.yml or stop conflicting service

Build Fails 

# Clean and rebuild
./build.sh clean
./build.sh build

Extensions Not Loading

  • Check browser console for errors
  • Ensure extension is compatible with WAIIDE Web

📚 Next Steps

💬 Need Help?

Happy coding with CalliopeAI! 🚀✨

🔧 Installing WAIIDE🚀 Getting Started with WAIIDE