Docs /guides/ Community Templates
guides / community

Community Templates

Explore the Sinapsis community Template starter repository and run its sample Agents.

communitytemplatesexamplescontributingDocumentation latest

Source: Sinapsis Community Contributions — GitHub

sinapsis-contrib is the Sinapsis community starter repository for creating and testing reusable Templates. It includes example synchronous and asynchronous Templates, Agent configurations, development tooling, test scaffolding and optional Docker support.

The full example source and setup instructions are maintained in the repository. This page is an entry point, not a duplicate of its README.

What's included

  • A standard src/sinapsis_contrib/templates/ package with KeywordTaggerTemplate and AsyncKeywordTaggerTemplate examples.

  • Corresponding example Agent YAML files under src/sinapsis_contrib/configs/.

  • Baseline contract and discovery tests, plus space for Template-specific tests.

  • Development tooling built around uv, pytest, Ruff and pre-commit.

  • Optional CPU/GPU Docker images and CI workflows.

Getting started

For local development, the repository lists Python 3.10+ and uv as prerequisites:

Terminalbash
git clone https://github.com/Sinapsis-AI/sinapsis-contrib.git
cd sinapsis-contrib
uv sync

The synchronous example Agent is documented as:

Terminalbash
sinapsis run src/sinapsis_contrib/configs/keyword_tagger.yaml

The asynchronous example uses a separate runtime:

Terminalbash
sinapsis-async run src/sinapsis_contrib/configs/async_keyword_tagger.yaml

Access note: sinapsis-async is described in the contributing guide as being distributed through a private package index and requiring a Sinapsis account. The synchronous quickstart and asynchronous quickstart do not necessarily have the same prerequisites; consult the current repository before running either example.

Next steps

To build a new Template package, follow Contributing Templates and the repository's full CONTRIBUTING.md.

For the underlying interface and declarative graphs, see Templates and Agents.

Published from Git revision 7b7ba25d627b