# blaxel-sdk

Скилл учит агента поднимать облачные microVM-песочницы Blaxel, запускать в них dev-серверы и получать ссылку на живой предпросмотр.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 611 установок · ★ 3
- Автор: blaxel-ai
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/blaxel-ai/agent-skills/tree/HEAD/skills/blaxel-sdk/SKILL.md
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/skills/blaxel-sdk

## Что делает

Скилл описывает работу с Blaxel — платформой, где агент получает собственное вычислительное окружение. Основной сценарий: создать песочницу из публичного образа (`blaxel/node:latest`, `blaxel/nextjs:latest`, `blaxel/py-app:latest` и другие), записать туда файлы, поставить зависимости, запустить команды и открыть preview URL. Порты объявляются при создании песочницы, добавить их потом нельзя; 80, 443 и 8080 зарезервированы.

Внутри — справочник по SDK на TypeScript (`@blaxel/core`) и Python (`blaxel`) плюс CLI `bl`. Авторизация идёт по приоритету: сначала залогиненный CLI, затем переменные `BL_WORKSPACE` и `BL_API_KEY` из `.env`, потом системные переменные и файл `~/.blaxel/config.yaml`. Для локальной разработки достаточно `bl login YOUR-WORKSPACE`, для CI — экспорт переменных.

Отдельный пункт, на котором легко споткнуться: dev-сервер должен слушать `0.0.0.0`, а не `localhost`, иначе preview URL его не увидит. Ещё скилл советует `createIfNotExists` вместо пары get-then-create: удалённая песочница ещё несколько минут висит в состоянии `TERMINATED`, и обычный `get` вернёт мёртвый экземпляр с нерабочим шлюзом. Свежие версии SDK пережидают окно `DELETING`, на старых вызов может упасть с ошибкой после трёх попыток.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add blaxel-ai/agent-skills --skill blaxel-sdk -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/blaxel-sdk/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/blaxel-sdk/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add blaxel-ai/agent-skills --skill blaxel-sdk -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/blaxel-sdk/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add blaxel-ai/agent-skills --skill blaxel-sdk -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/blaxel-sdk/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install blaxel-ai/agent-skills blaxel-sdk
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/blaxel-sdk/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add blaxel-ai/agent-skills --skill blaxel-sdk -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/blaxel-ai/agent-skills --path skills/blaxel-sdk
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/blaxel-sdk/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add blaxel-ai/agent-skills --skill blaxel-sdk -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/blaxel-ai/agent-skills/tree/HEAD/skills/blaxel-sdk/SKILL.md

## Когда брать
- поднять изолированную microVM-песочницу и выполнить в ней код
- запустить dev-сервер и получить публичную ссылку на предпросмотр
- собрать шаблон окружения из своего Docker-образа
- задеплоить AI-агента, MCP-сервер или batch-задачу как serverless-эндпоинт
- дать нескольким песочницам общий файловый том через Agent Drives

## Примеры запросов агенту
- Создай песочницу blaxel из образа blaxel/node:latest с портом 3000 и запусти там npm run dev
- Запиши файлы проекта в /app, поставь зависимости и открой preview URL на порту 3000
- Задеплой этого агента на Blaxel как serverless-эндпоинт

## Похожие
- [sandbox](https://affpapa.org/nevibecode/skills/vercel-inc-sandbox.md) — скилл · 604 установки
- [sandbox-sdk](https://affpapa.org/nevibecode/skills/sandbox-sdk.md) — скилл · 4 установки
- [upstash-box-js](https://affpapa.org/nevibecode/skills/upstash-box-js.md) — скилл · 1200 установок
- [aws-lambda-microvms](https://affpapa.org/nevibecode/skills/aws-lambda-microvms.md) — скилл · 5600 установок
- [base44-cli](https://affpapa.org/nevibecode/skills/base44-cli.md) — скилл · 10900 установок
- [webflow-code-component:deploy-guide](https://affpapa.org/nevibecode/skills/webflow-code-componentdeploy-guide.md) — скилл · 987 установок

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md