Skip to content

mateusoliveiradev1/frescari / .agents/skills/dbos-python

dbos-python

Verified

DBOS Python SDK for building reliable, fault-tolerant applications with durable workflows. Use this skill when writing Python code with DBOS, creating workflows and steps, using queues, using DBOSC...

FileKindSize
AGENTS.mdmarkdown2.7 KB
CLAUDE.mdmarkdown9 B
SKILL.mdskill md2.6 KB
references/_sections.mdmarkdown1.4 KB
references/advanced-async.mdmarkdown2.5 KB
references/advanced-patching.mdmarkdown1.5 KB
references/advanced-versioning.mdmarkdown1.6 KB
references/client-enqueue.mdmarkdown1.4 KB
references/client-setup.mdmarkdown1.6 KB
references/comm-events.mdmarkdown1.5 KB
references/comm-messages.mdmarkdown1.5 KB
references/comm-streaming.mdmarkdown1.5 KB
references/lifecycle-config.mdmarkdown1.5 KB
references/lifecycle-fastapi.mdmarkdown1.5 KB
references/pattern-classes.mdmarkdown1.6 KB
references/pattern-debouncing.mdmarkdown1.6 KB
references/pattern-idempotency.mdmarkdown1.5 KB
references/pattern-scheduled.mdmarkdown1.5 KB
references/pattern-sleep.mdmarkdown1.3 KB
references/queue-basics.mdmarkdown1.3 KB
references/queue-concurrency.mdmarkdown1.3 KB
references/queue-deduplication.mdmarkdown1.6 KB
references/queue-listening.mdmarkdown1.6 KB
references/queue-partitioning.mdmarkdown1.8 KB
references/queue-priority.mdmarkdown1.5 KB
references/queue-rate-limiting.mdmarkdown1.3 KB
references/step-basics.mdmarkdown1.3 KB
references/step-retries.mdmarkdown1.4 KB
references/step-transactions.mdmarkdown1.7 KB
references/test-fixtures.mdmarkdown1.4 KB
references/workflow-background.mdmarkdown1.3 KB
references/workflow-constraints.mdmarkdown1.6 KB
references/workflow-control.mdmarkdown2.0 KB
references/workflow-determinism.mdmarkdown1.3 KB
references/workflow-introspection.mdmarkdown1.8 KB
references/workflow-timeout.mdmarkdown1.4 KB

references/client-enqueue.md

View on GitHub
---
title: Enqueue Workflows from External Applications
impact: HIGH
impactDescription: Enables decoupled architecture with separate API and worker services
tags: client, enqueue, workflow, external
---

## Enqueue Workflows from External Applications

Use `client.enqueue()` to submit workflows from outside the DBOS application. Must specify workflow and queue names explicitly.

**Incorrect (missing required options):**

```python
from dbos import DBOSClient

client = DBOSClient(system_database_url=db_url)

# Missing workflow_name and queue_name!
handle = client.enqueue({}, task_data)
```

**Correct (with required options):**

```python
from dbos import DBOSClient, EnqueueOptions

client = DBOSClient(system_database_url=db_url)

options: EnqueueOptions = {
    "workflow_name": "process_task",  # Required
    "queue_name": "task_queue",       # Required
}
handle = client.enqueue(options, task_data)
result = handle.get_result()
client.destroy()
```

With optional parameters:

```python
options: EnqueueOptions = {
    "workflow_name": "process_task",
    "queue_name": "task_queue",
    "workflow_id": "custom-id-123",
    "workflow_timeout": 300,
    "deduplication_id": "user-123",
    "priority": 1,
}
```

Limitation: Cannot enqueue workflows that are methods on Python classes.

Reference: [DBOSClient.enqueue](https://docs.dbos.dev/python/reference/client#enqueue)
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 467kUpdated Claude CodeCodexVerifiedInstall
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 467kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 319kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 319kUpdated Claude CodeCodexVerifiedInstall