Initial: opencode-ai HF Space with NVIDIA NIM

AGENTS.md

@@ -0,0 +1,54 @@
+# HF Space Agent System Instructions
+
+You are an AI coding agent running inside a Hugging Face Space. You have access to NVIDIA NIM (Llama 3.1 8B) for LLM capabilities and the Hugging Face Hub API for infrastructure.
+
+## Environment
+
+Your HF token is available as `HF_TOKEN` env var, NVIDIA API key as `NVIDIA_API_KEY`.
+
+## Project Workflow
+
+You work on ONE project at a time. Each project gets its own dedicated HF Space.
+
+### Starting a new project
+
+When the user asks to start or work on a project:
+
+1. **Plan** the project structure and requirements
+2. **Create a HF Space** for the project using Python:
+   ```python
+   from huggingface_hub import HfApi
+   api = HfApi(token=HF_TOKEN)
+   api.create_repo(
+       repo_id=f"{namespace}/{project-slug}",
+       repo_type="space",
+       space_sdk="docker",
+       private=True,
+       exist_ok=False,
+   )
+   ```
+3. **Develop** in the project Space:
+   - Push code to the Space's git repo
+   - Set environment secrets via `api.add_space_secret()`
+   - Use the Space as the isolated environment for that project
+4. **Iterate**: Make changes, commit, push, the Space rebuilds automatically
+
+### Working on existing projects
+
+- Track project Spaces and their statuses
+- Pull latest code, make changes, push
+- Check Space logs for build/runtime errors
+
+### When the project is done
+
+- Present the URL of the project Space to the user
+- Keep the Space around unless user asks to delete it
+
+## Rules
+
+- Do NOT write project code in the home Space directory (`/home/node/app`)
+- Each project lives in its OWN HF Space
+- Use `python3` and the `huggingface_hub` library for all HF API calls
+- If python3 or huggingface_hub is not installed, install with pip
+- Ask the user for the namespace/username to use for project Spaces
+- One project at a time unless explicitly asked to multitask

Dockerfile

@@ -0,0 +1,21 @@
+FROM node:20
+
+RUN apt-get update && apt-get install -y curl git dos2unix && rm -rf /var/lib/apt/lists/*
+
+WORKDIR /home/node/app
+RUN chown -R node:node /home/node/app
+
+USER node
+
+ENV NPM_CONFIG_PREFIX=/home/node/.npm-global
+ENV PATH=/home/node/.npm-global/bin:$PATH
+
+RUN npm install -g opencode-ai
+
+COPY --chown=node:node . .
+
+RUN dos2unix start.sh && chmod +x start.sh
+
+EXPOSE 7860
+
+CMD ["/bin/bash", "./start.sh"]

README.md

@@ -0,0 +1,44 @@
+# OpenCode HF Space
+
+An AI coding agent running in your browser via Hugging Face Spaces, powered by NVIDIA NIM.
+
+## Deploy
+
+### 1. Create the Space on HF
+
+```python
+from huggingface_hub import HfApi, SpaceHardware
+
+api = HfApi(token="hf_...")
+api.create_repo(
+    repo_id="your-username/opencode-space",
+    repo_type="space",
+    space_sdk="docker",
+    space_hardware=SpaceHardware.CPU_BASELINE,
+    private=False,
+    exist_ok=False,
+)
+```
+
+### 2. Set secrets
+
+Set these Space secrets via HF UI or API:
+
+| Secret | Value |
+|--------|-------|
+| `NVIDIA_API_KEY` | Your NVIDIA NIM API key |
+| `HF_TOKEN` | Your HF token with Space creation permissions |
+
+### 3. Push code
+
+```bash
+git init
+git add .
+git commit -m "Initial deploy"
+git remote add space https://huggingface.co/spaces/your-username/opencode-space
+git push space main
+```
+
+### 4. Open
+
+Wait for the Space to build, then visit `https://your-username-opencode-space.hf.space`

start.sh

@@ -0,0 +1,28 @@
+#!/bin/bash
+set -e
+
+mkdir -p /home/node/.config/opencode
+
+cat > /home/node/.config/opencode/opencode.json << 'CONFIG'
+{
+  "$schema": "https://opencode.ai/config.json",
+  "model": "nvidia/meta/llama-3.1-8b-instruct",
+  "provider": {
+    "nvidia": {
+      "npm": "@ai-sdk/openai-compatible",
+      "name": "NVIDIA NIM",
+      "options": {
+        "baseURL": "https://integrate.api.nvidia.com/v1",
+        "apiKey": "{env:NVIDIA_API_KEY}"
+      }
+    }
+  },
+  "instructions": ["AGENTS.md"],
+  "server": {
+    "port": 7860,
+    "hostname": "0.0.0.0"
+  }
+}
+CONFIG
+
+exec opencode web --port 7860 --hostname 0.0.0.0