# Agently Fastapi Service

> FastAPI service wrappers for Agently Agent + TriggerFlow (POST, SSE, WebSocket).

- Skill: `agentera/agently-fastapi-service` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add agentera/agently-fastapi-service`
- Raw SKILL.md: https://api.skillmd.com/api/skills/agentera/agently-fastapi-service/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: agentera (https://skillmd.com/u/agentera)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/agentera/agently-fastapi-service

---


# Agently FastAPI Service Skill

Use this skill to expose Agently/TriggerFlow as HTTP and streaming APIs.

## Key Patterns
- POST endpoint for one-shot responses.
- SSE endpoint for streaming deltas.
- WebSocket endpoint for duplex streaming.

## Pitfalls to Avoid (Lessons from NexusTodo)
- Stream event types should be explicit (`delta`, `action`, `execution`, `done`, `error`).
- Only send cards or final summaries in `done` to avoid duplicates in the UI.
- Enforce identity + auth headers (`Authorization`, `X-User-ID`, `X-Device-ID`) on every request.
- Prefer GET query params for SSE when payload is small; rely on `sessionId` for context.

## References
- `examples/fastapi_triggerflow_service.py`

## Examples
See `examples/run.sh` for runnable commands.