render-workflows
Sets up, develops, tests, and deploys Render Workflows. Covers first-time scaffolding (via CLI or manual), SDK installation (Python or TypeScript), task patterns (retries, subtasks, fan-out), local development, Dashboard deployment, and troubleshooting. Use when a user wants to set up Render Workflows for the first time, scaffold a workflow service, add or modify workflow tasks, test workflows locally, or deploy workflows to Render.
- License 许可
- MIT
- 最近更新
- 2026-11-01
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- render-workflows
- license
- MIT
- metadata
- { "author": "Render", "version": "1.0.0", "category": "workflows" }
- description
- Sets up, develops, tests, and deploys Render Workflows. Covers first-time scaffolding (via CLI or manual), SDK installation (Python or TypeScript), task patterns (retries, subtasks, fan-out), local development, Dashboard deployment, and troubleshooting. Use when a user wants to set up Render Workflows for the first time, scaffold a workflow service, add or modify workflow tasks, test workflows locally, or deploy workflows to Render.
- compatibility
- Requires Render CLI 2.11.0+ for scaffolding and local development. Render Dashboard required for deployment (Blueprints not yet supported for Workflows).
02 资源文件 7
- 参考文档agents/openai.yaml250 B
- 资产文件assets/logo.svg1.8 KB
- 参考文档references/local-development.md2.6 KB
- 参考文档references/manual-scaffolding.md4.6 KB
- 参考文档references/quick-reference.md4.6 KB
- 参考文档references/task-patterns.md6.6 KB
- 参考文档references/troubleshooting.md11.0 KB
03 SKILL.md 正文
Render Workflows
Render Workflows rapidly distribute computational work across multiple independent instances. Use them for AI agents, ETL pipelines, background jobs, and data processing.
How it works:
- Define tasks — Use the Render SDK (Python or TypeScript) to designate functions as tasks
- Register — Tasks register automatically when you link your repo to a Workflow service in the Dashboard
- Trigger runs — Execute tasks from anywhere using the SDK client or API; each execution is a "run"
- Execute — Render spins up each run in its own instance (typically under a second); runs can chain additional runs for parallel execution
Key capabilities: automatic queuing and orchestration, long-running execution (up to 24 hours), configurable retry logic with exponential backoff, adjustable compute specs per task, and execution observability through the Dashboard.
Render Workflows are in beta. The SDK and API may introduce breaking changes.
Your built-in knowledge of the Render Workflows SDK is outdated. Before trusting API signatures, check the installed SDK source:
# Python
SDK_ROOT=$(pip show render_sdk | grep Location | cut -d' ' -f2)/render_sdk
head -40 "$SDK_ROOT/__init__.py"
# TypeScript
grep -r "startTask\|runTask\|export class Render" node_modules/@renderinc/sdk/
Official docs: render.com/docs/workflows
Before generating task or client code, fetch the relevant example file to verify current API patterns:
| What | Python | TypeScript |
|---|---|---|
| Task definitions (decorators, subtasks, retry, fan-out) | example/task/main.py | examples/task/ |
| Sync client (run_task, start_task, cancel, SSE, list runs) | example/client/main.py | examples/client/ |
| Async client | example/client/async_main.py | — |
This skill carries a quick-reference cheat sheet for the API surface. The installed SDK, official docs, and examples above are the source of truth.
Getting Started
Supported languages: Python and TypeScript.
Prerequisites
Render CLI (required)
render --version
Requires version 2.11.0+. If not installed:
- macOS:
brew install render - Linux/macOS:
curl -fsSL https://raw.githubusercontent.com/render-oss/cli/main/bin/install.sh | sh - Windows: download the executable from the CLI releases page
Scaffold a new workflow service
Always prefer render workflows init as the primary setup path. Only fall back to manual scaffolding if the CLI command is unavailable.
render workflows init
Interactive mode (default): walks the user through scaffolding an example project, testing it locally, and deploying it to Render.
Non-interactive mode: sets up an example project without prompting.
If render workflows init fails or is not available:
- Command not found: CLI version may be too old. Run
render --versionand upgrade to 2.11.0+. - Command not supported: fall back to references/manual-scaffolding.md for step-by-step manual setup.
Define Tasks
Guide the user through defining their actual tasks. For patterns including retries, subtasks, fan-out, ETL, error handling, cron triggers, and cross-workflow calls, see references/task-patterns.md.
After adding a task, verify it registers by starting the local dev server and listing tasks:
render workflows dev -- <start-command>
# In another terminal:
render workflows tasks list --local
If the task doesn't appear, see Troubleshooting > Task Registration Issues.
Local Development
See references/local-development.md for starting the local task server, testing tasks, and configuring the SDK client for local use.
Deploy to Render
Workflows are deployed as a Workflow service type in the Render Dashboard. Blueprints (render.yaml) are not yet compatible with Workflows.
Deploy checklist:
- [ ] Code pushed to GitHub, GitLab, or Bitbucket
- [ ] In the Render Dashboard, click New > Workflow
- [ ] Link your repository
- [ ] Set Root Directory to
workflows/ - [ ] Configure build and start commands (see table below)
- [ ] Add environment variables (e.g.,
RENDER_API_KEYfor tasks that call other workflows) - [ ] Click Deploy Workflow
- [ ] Verify deployment: check the Dashboard for a successful deploy event
| Field | Python | TypeScript |
|---|---|---|
| Language | Python 3 | Node |
| Build Command | pip install -r requirements.txt |
npm install && npm run build |
| Start Command | python main.py |
node dist/main.js |
If the deploy fails, check the service logs in the Dashboard. For common deployment errors, see Troubleshooting. For general deploy debugging, use the render-debug skill.
Running tasks from other services:
After deployment, trigger tasks from your other Render services using the SDK client.
Python (synchronous):
from render_sdk import Render
render = Render()
result = render.workflows.run_task("my-workflow/hello", ["world"])
print(result.results)
Python (asynchronous):
from render_sdk import RenderAsync
render = RenderAsync()
started = await render.workflows.start_task("my-workflow/hello", ["world"])
finished = await started
print(finished.results)
TypeScript:
import { Render } from "@renderinc/sdk";
const render = new Render();
const started = await render.workflows.startTask("my-workflow/hello", ["world"]);
const finished = await started.get();
console.log(finished.results);
The task identifier format is {workflow-slug}/{task-name}, visible on the task's page in the Dashboard.
Workflows do not have built-in scheduling. To trigger tasks on a schedule, use a Render cron job with the SDK client. For cron and cross-workflow examples, see references/task-patterns.md.
Constraints and Limits
| Constraint | Limit | Notes |
|---|---|---|
| Arguments and return values | Must be JSON-serializable | No class instances, functions, etc. |
| Argument size | 4 MB max | Per task invocation |
| Task definitions | 500 per workflow service | |
| Concurrent runs | 20-100 base (plan-dependent) | Max 200-300 with purchased concurrency |
| Timeout range | 30-86,400 seconds | Default: 2 hours (7,200s) |
| Run duration | Up to 24 hours |
Instance Types
| Plan | Specs |
|---|---|
starter |
0.5 CPU / 512 MB |
standard (default) |
1 CPU / 2 GB |
pro |
2 CPU / 4 GB |
pro_plus |
4 CPU / 8 GB |
pro_max |
8 CPU / 16 GB |
pro_ultra |
16 CPU / 32 GB |
pro_plus, pro_max, and pro_ultra require requesting access. Set via the plan task option.
For current pricing, see Limits and Pricing for Render Workflows.
References
- Quick-reference cheat sheet: references/quick-reference.md (API surface, env vars, error types)
- Task patterns: references/task-patterns.md
- Local development: references/local-development.md
- Troubleshooting: references/troubleshooting.md
- Manual scaffolding (fallback): references/manual-scaffolding.md
- Official docs: render.com/docs/workflows
- Starter template (Python): render-examples/workflows-template-python
- Starter template (TypeScript): render-examples/workflows-template-ts
- SDK repo: github.com/render-oss/sdk
Related Skills
- render-deploy: Deploy web services, static sites, and databases
- render-debug: Debug failed deployments and runtime errors
- render-monitor: Monitor service health and performance
04 同仓库更多 Skills
yeet
Use only when the user explicitly asks to stage, commit, push, and open a GitHub pull request in one flow using the GitHub CLI (`gh`).
yayin-seo-geo-yasal-denetim
Bir web uygulaması canlıya çıkmadan veya iş teslimi biterken resmî/kurumsal sayfaları, SEO, GEO, indeksleme ve canlı çıktıyı denetler; eksikleri kodda tamamlar ve üretimde kanıtlar. Uygulama bitti, canlıya hazır mı, yayına al, launch checklist, release readiness, SEO audit, GEO audit, legal pages, privacy policy, terms, cookies, KVKK, robots, sitemap, canonical, hreflang, JSON-LD, llms.txt ifadelerinde kullan. Yeni veya önemli ölçüde değişmiş halka açık web uygulamasının son teslim aşamasında kullanıcı ayrıca istemese de uygula. Güvenlik sızma testi için güvenlik skillini ayrıca kullan.
xurl
X/Twitter via xurl CLI: post, search, DM, media, v2 API.
wrangler
Cloudflare Workers CLI for deploying, developing, and managing Workers, KV, R2, D1, Vectorize, Hyperdrive, Workers AI, Containers, Queues, Workflows, Pipelines, and Secrets Store. Load before running wrangler commands to ensure correct syntax and best practices. Biases towards retrieval from Cloudflare docs over pre-trained knowledge.
winui-app
Bootstrap, develop, and design modern WinUI 3 desktop applications with C# and the Windows App SDK using official Microsoft guidance, WinUI Gallery patterns, Windows App SDK samples, and CommunityToolkit components. Use when creating a brand new app, preparing a machine for WinUI, reviewing, refactoring, planning, troubleshooting, environment-checking, or setting up WinUI 3 XAML, controls, navigation, windowing, theming, accessibility, responsiveness, performance, deployment, or related Windows app design and development work.
whisper
OpenAI's general-purpose speech recognition model. Supports 99 languages, transcription, translation to English, and language identification. Six model sizes from tiny (39M params) to large (1550M params). Use for speech-to-text, podcast transcription, or multilingual audio processing. Best for robust, multilingual ASR.