spawn/fluidstack/README.md
A efec4ac8ca
feat: Add FluidStack GPU cloud provider with claude, aider, and gptme agents (#247)
FluidStack is a cost-effective GPU cloud provider offering A100s and H100s
starting at $1.35/hr (up to 70% cheaper than hyperscalers). Features:

- Simple REST API with Python SDK
- SSH access with automatic key registration
- Zero egress fees
- GPU types: RTX_4090 (default), A100, H100

Implemented agents:
- Claude Code (fluidstack/claude.sh)
- Aider (fluidstack/aider.sh)
- gptme (fluidstack/gptme.sh)

Added fluidstack/lib/common.sh with provisioning primitives.
Updated manifest.json with cloud entry and matrix entries (3 implemented, 11 missing).

Agent: cloud-scout

Co-authored-by: B <6723574+louisgv@users.noreply.github.com>
Co-authored-by: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-10 14:09:25 -08:00

56 lines
1.5 KiB
Markdown

# FluidStack
FluidStack GPU cloud via REST API. [FluidStack](https://www.fluidstack.io/)
## Prerequisites
1. A FluidStack account with API key from [Dashboard API Keys](https://platform.fluidstack.io/dashboard/api-keys)
2. SSH public key (will be registered automatically)
## Agents
#### Claude Code
```bash
bash <(curl -fsSL https://openrouter.ai/lab/spawn/fluidstack/claude.sh)
```
#### Aider
```bash
bash <(curl -fsSL https://openrouter.ai/lab/spawn/fluidstack/aider.sh)
```
#### gptme
```bash
bash <(curl -fsSL https://openrouter.ai/lab/spawn/fluidstack/gptme.sh)
```
## Non-Interactive Mode
```bash
FLUIDSTACK_SERVER_NAME=dev-gpu \
FLUIDSTACK_API_KEY=your-api-key \
OPENROUTER_API_KEY=sk-or-v1-xxxxx \
bash <(curl -fsSL https://openrouter.ai/lab/spawn/fluidstack/claude.sh)
```
## Environment Variables
| Variable | Description | Default |
|---|---|---|
| `FLUIDSTACK_API_KEY` | FluidStack API key | _(prompted)_ |
| `FLUIDSTACK_SERVER_NAME` | Instance name | _(prompted)_ |
| `FLUIDSTACK_GPU_TYPE` | GPU type (e.g., `RTX_4090`, `A100`, `H100`) | `RTX_4090` |
| `FLUIDSTACK_SSH_KEY_NAME` | SSH key name | `spawn-${USER}` |
| `OPENROUTER_API_KEY` | OpenRouter API key | _(prompted via OAuth)_ |
## Notes
- FluidStack is a GPU cloud provider with A100s and H100s starting at $1.35/hr
- Up to 70% cheaper than traditional hyperscalers
- Zero egress fees for data transfer
- Simple REST API with Python SDK available
- SSH keys are automatically registered via the API
- Instances use the `root` user for SSH access