Duplicate from p-yan/opencode-cloud

Co-authored-by: Peter Yan <p-yan@users.noreply.huggingface.co>

.gitattributes

@@ -0,0 +1,35 @@
+*.7z filter=lfs diff=lfs merge=lfs -text
+*.arrow filter=lfs diff=lfs merge=lfs -text
+*.bin filter=lfs diff=lfs merge=lfs -text
+*.bz2 filter=lfs diff=lfs merge=lfs -text
+*.ckpt filter=lfs diff=lfs merge=lfs -text
+*.ftz filter=lfs diff=lfs merge=lfs -text
+*.gz filter=lfs diff=lfs merge=lfs -text
+*.h5 filter=lfs diff=lfs merge=lfs -text
+*.joblib filter=lfs diff=lfs merge=lfs -text
+*.lfs.* filter=lfs diff=lfs merge=lfs -text
+*.mlmodel filter=lfs diff=lfs merge=lfs -text
+*.model filter=lfs diff=lfs merge=lfs -text
+*.msgpack filter=lfs diff=lfs merge=lfs -text
+*.npy filter=lfs diff=lfs merge=lfs -text
+*.npz filter=lfs diff=lfs merge=lfs -text
+*.onnx filter=lfs diff=lfs merge=lfs -text
+*.ot filter=lfs diff=lfs merge=lfs -text
+*.parquet filter=lfs diff=lfs merge=lfs -text
+*.pb filter=lfs diff=lfs merge=lfs -text
+*.pickle filter=lfs diff=lfs merge=lfs -text
+*.pkl filter=lfs diff=lfs merge=lfs -text
+*.pt filter=lfs diff=lfs merge=lfs -text
+*.pth filter=lfs diff=lfs merge=lfs -text
+*.rar filter=lfs diff=lfs merge=lfs -text
+*.safetensors filter=lfs diff=lfs merge=lfs -text
+saved_model/**/* filter=lfs diff=lfs merge=lfs -text
+*.tar.* filter=lfs diff=lfs merge=lfs -text
+*.tar filter=lfs diff=lfs merge=lfs -text
+*.tflite filter=lfs diff=lfs merge=lfs -text
+*.tgz filter=lfs diff=lfs merge=lfs -text
+*.wasm filter=lfs diff=lfs merge=lfs -text
+*.xz filter=lfs diff=lfs merge=lfs -text
+*.zip filter=lfs diff=lfs merge=lfs -text
+*.zst filter=lfs diff=lfs merge=lfs -text
+*tfevents* filter=lfs diff=lfs merge=lfs -text

Dockerfile

@@ -0,0 +1,36 @@
+FROM node:20-bookworm-slim
+
+# System dependencies
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    git \
+    ca-certificates \
+    curl \
+    && rm -rf /var/lib/apt/lists/*
+
+# Install OpenCode globally via the official installer.
+# OPENCODE_INSTALL_DIR points the installer at /usr/local/bin so the
+# `opencode` binary is on the default PATH for every user.
+ENV OPENCODE_INSTALL_DIR=/usr/local/bin
+RUN curl -fsSL https://opencode.ai/install | bash
+
+# Hugging Face Spaces runs containers as UID 1000.
+RUN useradd -m -u 1000 user
+
+ENV HOME=/home/user
+# Make sure the `user` account picks up /usr/local/bin (root's PATH already
+# includes it, but $HOME/.local/bin is the conventional place for user bins).
+ENV PATH=/home/user/.local/bin:/usr/local/bin:${PATH}
+
+# Create a workspace directory the user can clone projects into and own it.
+RUN mkdir -p $HOME/workspace && chown -R user:user $HOME
+
+USER user
+WORKDIR $HOME/workspace
+
+# The port must match `app_port` in the README's YAML block.
+EXPOSE 4096
+
+# Start the OpenCode web server.
+# --hostname 0.0.0.0  => reachable by HF's reverse proxy (not just localhost)
+# OPENCODE_SERVER_PASSWORD env var (set as a Space secret) enables basic auth.
+CMD ["opencode", "web", "--port", "4096", "--hostname", "0.0.0.0"]

README.md

@@ -0,0 +1,87 @@
+---
+title: OpenCode Cloud
+emoji: 🤖
+colorFrom: blue
+colorTo: indigo
+sdk: docker
+app_port: 4096
+pinned: false
+license: mit
+---
+
+# OpenCode on Hugging Face Spaces
+
+Run [OpenCode](https://opencode.ai) — an open-source AI coding agent that supports 75+ LLM providers — in your browser, hosted on Hugging Face's free CPU tier.
+
+## Setup (one-time, ~2 minutes)
+
+1. **Duplicate this Space** to your own HF account (top-right → `Duplicate Space`).
+2. **Add your secrets** in **Settings → Variables and secrets**:
+
+   | Secret name | Required? | Where to get it |
+   |---|---|---|
+   | `OPENCODE_SERVER_PASSWORD` | Yes | Any password you choose — protects the web UI |
+   | `ANTHROPIC_API_KEY` | One of these | https://console.anthropic.com |
+   | `OPENAI_API_KEY` | (pick your | https://platform.openai.com/api-keys |
+   | `GEMINI_API_KEY` | provider) | https://aistudio.google.com/apikey |
+   | `OPENCODE_API_KEY` | | https://opencode.ai/zen (curated models) |
+
+3. The Space will rebuild (~60-90 seconds) and start on the URL shown above.
+4. Log in with username **`opencode`** and the password you set.
+
+That's it. You now have a free, browser-accessible AI coding agent.
+
+## How it works
+
+- The `Dockerfile` installs [OpenCode](https://opencode.ai) via the official install script and runs `opencode web`.
+- The web UI is bound to `0.0.0.0:4096` so HF's reverse proxy can reach it.
+- HTTP basic auth is enabled via the `OPENCODE_SERVER_PASSWORD` secret.
+- Your workspace lives at `/home/user/workspace` inside the container.
+
+## Using OpenCode
+
+Once you're in the web UI:
+
+- **New session** → describe what you want to build, refactor, or fix
+- **Files panel** → browse your workspace, upload code, or open the in-browser editor
+- **Plan mode** (press `Tab`) → have the agent draft a plan before changing anything
+- **Share** → get a public link to any session for sharing or debugging
+- **`/init`** → generates an `AGENTS.md` for your project so OpenCode remembers context across sessions
+
+For full usage docs, see https://opencode.ai/docs/
+
+## Persistence: read this
+
+**Free CPU Spaces are ephemeral.** Anything not pushed to git will be lost when the Space restarts (which happens after ~48h of inactivity, or when the free tier quota resets).
+
+**Recommended workflow:**
+
+1. In the OpenCode terminal, `cd workspace`
+2. `git clone https://github.com/your-user/your-repo.git`
+3. Work on the project
+4. `git add . && git commit -m "..." && git push` before stepping away
+
+For pure scratch work (no git), everything resets on restart — so commit early and often.
+
+## Caveats
+
+- **CPU only** — no GPU. The agent works fine; you just can't run local LLMs here.
+- **Sleeps after ~48h idle** on the free tier (Hugging Face does this automatically).
+- **Resource limits** — free CPU Spaces are throttled compared to local dev. Heavy multi-file refactors can be slower.
+- **No outbound ports** — the agent can `git clone` public repos, but you can't expose additional services.
+- **CORS / session storage** — sessions live in the container's filesystem, so restarts wipe them. Use the `/share` command to save a session URL externally.
+
+## If you want to upgrade later
+
+When you outgrow the free tier:
+
+| Need | Upgrade to |
+|---|---|
+| Always-on, no sleep | HF Spaces paid CPU ($0.03/hr ≈ $5/mo) |
+| Persistent storage | HF Spaces Storage bucket add-on |
+| More CPU/RAM | Spaces hardware upgrade to `cpu-upgrade` or `cpu-performance` |
+| Always-on + git auto-sync | Self-host on Oracle Cloud Always Free (24GB RAM, 4 ARM cores) — different guide |
+
+## License
+
+MIT. OpenCode is © Anomaly. This Dockerfile is just glue.