Merge pull request #6 from itomek/issue-3-remove-docker-compose

Remove Docker Compose support and default LEMONADE_BASE_URL

Author: itomek

.claude/agents/docker-specialist.md

@@ -9,7 +9,6 @@ This project provides a Docker container for GAIA (AMD's AI agent platform), bui
 ## Key Files
 
 - **Dockerfile** - Multi-stage container definition
-- **docker-compose.yml** - Development orchestration
 - **entrypoint.sh** - Runtime initialization script
 
 ## Dockerfile Architecture
@@ -67,36 +66,22 @@ ENV TZ="$TZ"
 **Environment variables:**
 - `GAIA_VERSION` - Version to install (default: 0.15.1)
 - `SKIP_INSTALL` - Skip installation for faster restarts (default: false)
-- `LEMONADE_BASE_URL` - Lemonade API endpoint (default: http://localhost:5000/api/v1)
+- `LEMONADE_BASE_URL` - Lemonade API endpoint (required)
 
-## Docker Compose Configuration
-
-**Service:** gaia-dev
-
-**Key configuration:**
-- Image naming: `itomek/gaia-dev:{VERSION}`
-- Container name: Customizable via `CONTAINER_NAME` env var
-- Resource limits: 4 CPUs, 8GB memory (adjustable)
-- Optional host directory mounting via `HOST_DIR`
-- Interactive mode: tty + stdin_open for shell access
-
-**Environment variables:**
-- `LEMONADE_BASE_URL` - Lemonade server configuration
-- `SKIP_INSTALL` - Control GAIA installation behavior
 
 ## Common Tasks
 
 ### Building Images
 
 ```bash
 # Default version (from Dockerfile)
-docker build -t gaia-dev .
+docker build -t gaia-linux .
 
 # Specific GAIA version
-docker build --build-arg GAIA_VERSION=0.15.1 -t gaia-dev:0.15.1 .
+docker build --build-arg GAIA_VERSION=0.15.1 -t gaia-linux:0.15.1 .
 
 # Different timezone
-docker build --build-arg TZ=UTC -t gaia-dev .
+docker build --build-arg TZ=UTC -t gaia-linux .
 ```
 
 ### Multi-Architecture Builds
@@ -107,21 +92,28 @@ The project supports linux/amd64 and linux/arm64:
 docker buildx build \
   --platform linux/amd64,linux/arm64 \
   --build-arg GAIA_VERSION=0.15.1 \
-  -t itomek/gaia-dev:0.15.1 \
+  -t itomek/gaia-linux:0.15.1 \
   --push .
 ```
 
 ### Development Workflow
 
 ```bash
 # Start container
-docker-compose up -d
+docker run -dit \
+  --name gaia-linux \
+  -e LEMONADE_BASE_URL=https://your-server.com/api/v1 \
+  itomek/gaia-linux:0.15.1
 
 # Access shell
-docker exec -it gaia-dev zsh
+docker exec -it gaia-linux zsh
 
 # Fast restart (skip GAIA installation)
-SKIP_INSTALL=true docker-compose up -d
+docker run -dit \
+  --name gaia-linux \
+  -e LEMONADE_BASE_URL=https://your-server.com/api/v1 \
+  -e SKIP_INSTALL=true \
+  itomek/gaia-linux:0.15.1
 ```
 
 ## Best Practices for This Project

.cursor/rules/docker.mdc

@@ -2,7 +2,6 @@
 description: Docker and container-specific rules
 globs:
   - Dockerfile
-  - docker-compose.yml
   - entrypoint.sh
 ---
 

.cursor/rules/index.mdc

@@ -9,15 +9,14 @@ alwaysApply: true
 This is a Linux Docker container for AMD GAIA (AI framework). GAIA is installed from PyPI at container startup.
 
 ## Tech Stack
-- **Base**: Docker & Docker Compose
+- **Base**: Docker
 - **Python**: 3.12+ (managed with uv for fast package installation)
 - **Package Manager**: uv (10-100x faster than pip)
 - **Shell**: zsh (inside container)
 - **Target Application**: AMD GAIA framework
 
 ## Key Files
 - `Dockerfile`: Container image definition with Python 3.12 and tools
-- `docker-compose.yml`: Service configuration with environment variables
 - `entrypoint.sh`: Container startup script (installs GAIA from PyPI)
 - `pyproject.toml`: Python project configuration with test dependencies
 - `tests/`: Integration and unit tests using pytest
@@ -28,10 +27,10 @@ This is a Linux Docker container for AMD GAIA (AI framework). GAIA is installed
 - Uses uv for Python package installation (much faster than pip)
 
 ## Environment Variables
-Key env vars in docker-compose.yml:
-- `LEMONADE_BASE_URL`: Lemonade server base URL (default: http://localhost:5000/api/v1)
-- `GAIA_VERSION`: GAIA version to install from PyPI
-- `SKIP_INSTALL`: Skip pip install on restart (faster startup)
+Key environment variables for container:
+- `LEMONADE_BASE_URL`: Lemonade server base URL (required)
+- `GAIA_VERSION`: GAIA version to install from PyPI (default: 0.15.1)
+- `SKIP_INSTALL`: Skip pip install on restart (faster startup, default: false)
 
 ## Important Notes
 - This is a Linux container for GAIA

README.md

@@ -18,7 +18,7 @@ GAIA Linux container for [AMD GAIA](https://github.com/amd/gaia). GAIA is instal
 ### Prerequisites
 
 - Docker installed
-- Lemonade base URL (e.g., `http://localhost:5000/api/v1` or your server URL)
+- Lemonade server base URL
 
 ### 1. Pull the Image
 
@@ -36,20 +36,7 @@ docker pull itomek/gaia-linux:0.15.2  # When available
 
 ### 2. Run the Container
 
-**Option A: With Local Lemonade Server**
-
-If you have a Lemonade server running locally:
-
-```bash
-docker run -dit \
-  --name gaia-linux \
-  -e LEMONADE_BASE_URL=http://localhost:5000/api/v1 \
-  itomek/gaia-linux:0.15.1
-```
-
-**Option B: With Remote Lemonade Server**
-
-If you need to use a remote Lemonade server, set the `LEMONADE_BASE_URL` environment variable to your server's URL:
+Set the `LEMONADE_BASE_URL` environment variable to your Lemonade server:
 
 ```bash
 docker run -dit \
@@ -58,30 +45,7 @@ docker run -dit \
   itomek/gaia-linux:0.15.1
 ```
 
-**Note**: You can set any environment variable using the `-e` flag. See the [Environment Variables](#environment-variables) section below for all available options.
-
-**Option C: Using Docker Compose**
-
-Create a `docker-compose.yml`:
-
-```yaml
-version: '3.8'
-
-services:
-  gaia-linux:
-    image: itomek/gaia-linux:0.15.1
-    container_name: gaia-linux
-    environment:
-      - LEMONADE_BASE_URL=http://localhost:5000/api/v1  # Required
-    tty: true
-    stdin_open: true
-```
-
-Then run:
-
-```bash
-docker compose up -d
-```
+You can set any environment variable using the `-e` flag. See the [Environment Variables](#environment-variables) section below for all available options.
 
 ### 3. Connect to Container
 
@@ -99,34 +63,29 @@ For the rest of GAIA usage, see https://github.com/AMD/GAIA
 
 ## Environment Variables
 
-You can configure the container using environment variables. Set them using the `-e` flag with `docker run` or inline with `docker compose`.
+You can configure the container using environment variables. Set them using the `-e` flag with `docker run`.
 
 | Variable | Default | Description |
 |----------|---------|-------------|
-| `LEMONADE_BASE_URL` | **(required)** | Lemonade server base URL for GAIA LLM features. Example: `http://localhost:5000/api/v1` |
+| `LEMONADE_BASE_URL` | **(required)** | Lemonade server base URL for GAIA LLM features. |
 | `GAIA_VERSION` | `0.15.1` | GAIA version to install from PyPI. Usually matches the image tag, but can be overridden. |
 | `SKIP_INSTALL` | `false` | Skip package installation on startup (faster restarts). |
 
 ### Setting Environment Variables
 
-**With docker run:**
+Use the `-e` flag with `docker run`:
 ```bash
 docker run -dit \
   --name gaia-linux \
   -e LEMONADE_BASE_URL=https://your-server.com/api/v1 \
   itomek/gaia-linux:0.15.1
 ```
 
-**With docker compose:**
-```bash
-LEMONADE_BASE_URL=https://your-server.com/api/v1 docker compose up -d
-```
-
 ### Lemonade URL Examples
 
-Start your Lemonade server separately, then set `LEMONADE_BASE_URL` to its API endpoint.
+Start your Lemonade server separately, then set `LEMONADE_BASE_URL` to its API endpoint:
 
-- **Local Lemonade server**: `http://localhost:5000/api/v1`
+- **Local server**: `http://localhost:5000/api/v1`
 - **Remote server**: `https://your-remote-server.com/api/v1`
 
 ### External Lemonade
@@ -198,39 +157,47 @@ Follow the same instructions as above, but use your locally built image.
 ### Spawn Multiple Containers
 
 ```bash
-# Default container
-docker compose up -d
-
-# Second container (different name)
-CONTAINER_NAME=gaia-feature \
-  docker compose up -d
+# First container
+docker run -dit \
+  --name gaia-linux-main \
+  -e LEMONADE_BASE_URL=https://your-server.com/api/v1 \
+  itomek/gaia-linux:0.15.1
 
-# Third container (different name)
-CONTAINER_NAME=gaia-myfork \
-  docker compose up -d
+# Second container
+docker run -dit \
+  --name gaia-linux-feature \
+  -e LEMONADE_BASE_URL=https://your-server.com/api/v1 \
+  itomek/gaia-linux:0.15.1
 ```
 
 ### Connect to Specific Container
 
 ```bash
-docker exec -it gaia-feature zsh
+docker exec -it gaia-linux-feature zsh
 ```
 
 ### Destroy and Recreate
 
 ```bash
 # Stop and remove
-docker compose down
+docker stop gaia-linux-main && docker rm gaia-linux-main
 
-# Recreate fresh (fast with uv: ~2-3 minutes)
-docker compose up -d
+# Recreate fresh
+docker run -dit \
+  --name gaia-linux-main \
+  -e LEMONADE_BASE_URL=https://your-server.com/api/v1 \
+  itomek/gaia-linux:0.15.1
 ```
 
 ### Mount Host Directory for File Exchange
 
 ```bash
 # Mount ~/Public to /host in container
-HOST_DIR=/Users/yourname/Public docker compose up -d
+docker run -dit \
+  --name gaia-linux \
+  -e LEMONADE_BASE_URL=https://your-server.com/api/v1 \
+  -v /Users/yourname/Public:/host \
+  itomek/gaia-linux:0.15.1
 
 # Inside container
 ls /host
@@ -241,11 +208,11 @@ ls /host
 ```
 ┌─────────────────────────────────────────────────────────────┐
 │                     Docker Hub                               │
-│                  itomek/gaia-linux:0.15.1                     │
+│                  itomek/gaia-linux:0.15.1                   │
 │      (Python 3.12 + Node.js + tools)                         │
 └─────────────────────────────────────────────────────────────┘
                               │
-                              │ docker compose up
+                              │ docker run
                               ▼
 ┌─────────────────────────────────────────────────────────────┐
 │                   Container Start                            │
@@ -319,10 +286,7 @@ The container uses **uv** for Python package installation, which is 10-100x fast
 
 ```bash
 # Check logs
-docker compose logs
-
-# Check container logs
-docker compose logs
+docker logs gaia-linux
 ```
 
 ### GAIA Install Fails
@@ -337,21 +301,9 @@ docker exec -it gaia-linux bash -c "uv pip install --system 'amd-gaia[dev,mcp,ev
 
 ## Advanced Usage
 
-### Configure Lemonade Server
-
-**LEMONADE_BASE_URL is required** - set it to your Lemonade server's API endpoint.
-
-```bash
-LEMONADE_BASE_URL=https://your-server.com/api/v1 docker compose up -d
-```
-
 ### Build Image Locally
 
 ```bash
-# Build from Dockerfile
-docker compose build
-
-# Or with docker directly
 docker build -t gaia-linux:local .
 ```
 

dev.md

@@ -93,11 +93,15 @@ The CI workflow:
 ### Quick Manual Test
 
 ```bash
-docker compose up -d
-docker compose logs -f
+docker run -dit \
+  --name gaia-linux-test \
+  -e LEMONADE_BASE_URL=http://localhost:5000/api/v1 \
+  itomek/gaia-linux:0.15.1
+
+docker logs -f gaia-linux-test
 # Wait for "Ready for development"
-docker exec -it gaia-dev zsh -c "gaia --version"
-docker compose down
+docker exec -it gaia-linux-test zsh -c "gaia --version"
+docker stop gaia-linux-test && docker rm gaia-linux-test
 ```
 
 ### Automated Testing