dbos-python
Guide for building reliable, fault-tolerant Python applications with DBOS durable workflows. Use when adding DBOS to existing Python code, creating workflows and steps, or using queues for concurrency control.
- License 许可
- MIT
- 最近更新
- 2026-11-09
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- dbos-python
- risk
- safe
- source
- https://docs.dbos.dev/
- date_added
- 2026-02-27
- description
- Guide for building reliable, fault-tolerant Python applications with DBOS durable workflows. Use when adding DBOS to existing Python code, creating workflows and steps, or using queues for concurrency control.
02 资源文件 34
- 参考文档AGENTS.md2.7 KB
- 参考文档references/_sections.md1.4 KB
- 参考文档references/advanced-async.md2.5 KB
- 参考文档references/advanced-patching.md1.5 KB
- 参考文档references/advanced-versioning.md1.6 KB
- 参考文档references/client-enqueue.md1.4 KB
- 参考文档references/client-setup.md1.6 KB
- 参考文档references/comm-events.md1.5 KB
- 参考文档references/comm-messages.md1.5 KB
- 参考文档references/comm-streaming.md1.5 KB
- 参考文档references/lifecycle-config.md1.5 KB
- 参考文档references/lifecycle-fastapi.md1.5 KB
- 参考文档references/pattern-classes.md1.6 KB
- 参考文档references/pattern-debouncing.md1.6 KB
- 参考文档references/pattern-idempotency.md1.5 KB
- 参考文档references/pattern-scheduled.md1.5 KB
- 参考文档references/pattern-sleep.md1.3 KB
- 参考文档references/queue-basics.md1.3 KB
- 参考文档references/queue-concurrency.md1.3 KB
- 参考文档references/queue-deduplication.md1.6 KB
- 参考文档references/queue-listening.md1.6 KB
- 参考文档references/queue-partitioning.md1.8 KB
- 参考文档references/queue-priority.md1.5 KB
- 参考文档references/queue-rate-limiting.md1.3 KB
- 参考文档references/step-basics.md1.3 KB
- 参考文档references/step-retries.md1.4 KB
- 参考文档references/step-transactions.md1.7 KB
- 参考文档references/test-fixtures.md1.4 KB
- 参考文档references/workflow-background.md1.3 KB
- 参考文档references/workflow-constraints.md1.6 KB
- 参考文档references/workflow-control.md2.0 KB
- 参考文档references/workflow-determinism.md1.3 KB
- 参考文档references/workflow-introspection.md1.8 KB
- 参考文档references/workflow-timeout.md1.4 KB
03 SKILL.md 正文
DBOS Python Best Practices
Guide for building reliable, fault-tolerant Python applications with DBOS durable workflows.
When to Use
Reference these guidelines when:
- Adding DBOS to existing Python code
- Creating workflows and steps
- Using queues for concurrency control
- Implementing workflow communication (events, messages, streams)
- Configuring and launching DBOS applications
- Using DBOSClient from external applications
- Testing DBOS applications
Rule Categories by Priority
| Priority | Category | Impact | Prefix |
|---|---|---|---|
| 1 | Lifecycle | CRITICAL | lifecycle- |
| 2 | Workflow | CRITICAL | workflow- |
| 3 | Step | HIGH | step- |
| 4 | Queue | HIGH | queue- |
| 5 | Communication | MEDIUM | comm- |
| 6 | Pattern | MEDIUM | pattern- |
| 7 | Testing | LOW-MEDIUM | test- |
| 8 | Client | MEDIUM | client- |
| 9 | Advanced | LOW | advanced- |
Critical Rules
DBOS Configuration and Launch
A DBOS application MUST configure and launch DBOS inside its main function:
import os
from dbos import DBOS, DBOSConfig
@DBOS.workflow()
def my_workflow():
pass
if __name__ == "__main__":
config: DBOSConfig = {
"name": "my-app",
"system_database_url": os.environ.get("DBOS_SYSTEM_DATABASE_URL"),
}
DBOS(config=config)
DBOS.launch()
Workflow and Step Structure
Workflows are comprised of steps. Any function performing complex operations or accessing external services must be a step:
@DBOS.step()
def call_external_api():
return requests.get("https://api.example.com").json()
@DBOS.workflow()
def my_workflow():
result = call_external_api()
return result
Key Constraints
- Do NOT call
DBOS.start_workfloworDBOS.recvfrom a step - Do NOT use threads to start workflows - use
DBOS.start_workflowor queues - Workflows MUST be deterministic - non-deterministic operations go in steps
- Do NOT create/update global variables from workflows or steps
How to Use
Read individual rule files for detailed explanations and examples:
references/lifecycle-config.md
references/workflow-determinism.md
references/queue-concurrency.md
References
Limitations
- Use this skill only when the task clearly matches the scope described above.
- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.
04 同仓库更多 Skills
dei-assessment
Assess diversity, equity, and inclusion with metrics. TRIGGERS - Use when user needs help with dei-assessment related tasks.
dei-action-plan
Create DEI action plans with goals and initiatives. TRIGGERS - Use when user needs help with dei-action-plan related tasks.
culture-fit-assessment
Design culture add assessment processes. TRIGGERS - Use when user needs help with culture-fit-assessment related tasks.
cowork-to-code-bridge
Use an already-installed, independently verified cowork-to-code bridge to run narrowly approved actions on the user's own macOS, Linux, or WSL2 machine through a local file queue.
counter-offer-response
Draft counter-offer responses for retention. TRIGGERS - Use when user needs help with counter-offer-response related tasks.
continuous-feedback-system
Design continuous feedback systems. TRIGGERS - Use when user needs help with continuous-feedback-system related tasks.