# Agently Fastapi Service

> FastAPI service wrappers for Agently Agent + TriggerFlow (POST, SSE, WebSocket). Use when this capability is needed.

- Skill: `tomevault-io/agently-fastapi-service` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/agently-fastapi-service`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/agently-fastapi-service/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/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.

---
> Source: [AgentEra/Agently-NexusTodo](https://github.com/AgentEra/Agently-NexusTodo) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-16 -->