What do you want to do?
4 use cases
-
Send all app AI calls through one OpenAI-style endpoint
Point existing OpenAI SDK code at one gateway that routes to several providers with failover.
- Synapass
- Software and DevOps
- Intermediate
View prompt
Using the ShadowSafin/Synapass repo, deploy the stack with ./scripts/deploy.sh, mint a tenant key, and send one chat completion to /v1/chat/completions for the model <model_name>. Report the synapass.provider and synapass.fallback_used values. Verify that the HTTP status is 200 and the response contains a choices array.
-
Trace which provider and policy handled a bad AI answer
Look up a request ID to see the routing reason, policy verdict, and answering provider.
- Synapass
- Software and DevOps
- Intermediate
View prompt
In the ShadowSafin/Synapass repo, call GET /admin/v1/requests/<request_id>/explain with the admin key and summarize the routing reason and the answering provider. Verify that the summary names the same provider as the synapass.provider field in the original response.
-
Set spending limits so one team cannot run up the AI bill
Use tenant keys with budgets, rate limits, and per-request ceilings to control AI costs.
- Synapass
- Software and DevOps
- Advanced
View prompt
In the ShadowSafin/Synapass repo, create a tenant named <team_name> with a daily budget and a rate limit through the dashboard or admin API, then mint one key for it. Report the tenant id and confirm that a request above the configured ceiling is refused. Verify the refusal in the response before reporting success.
-
Run the gateway as a native service on a Linux server
Build and install Synapass without Docker, then run it under systemd.
- Synapass
- Software and DevOps
- Advanced
View prompt
In the ShadowSafin/Synapass repo, build with make build, install with synapass native install, and start with synapass native up on <host>. Report the output of curl -sf http://127.0.0.1:8080/ready. Verify that the readiness check succeeds before reporting the service as running.
How to use Synapass
- Check you have what it needs: Docker with Docker Compose, curl, and jq, or Go and Make for the native build; At least one provider API key such as OPENAI_API_KEY or ANTHROPIC_API_KEY in .env; A host with ports 8080 and 3000 free, or a changed GATEWAY_PORT.
- Open ShadowSafin/Synapass on GitHub and read the README and license.
- Run
./scripts/deploy.shfrom the cloned repo root, or the one-line installer for your OS from the README. - Add a provider key such as OPENAI_API_KEY to
.env, then run./scripts/deploy.shagain. - Create a tenant key with a POST to /admin/v1/keys using the admin key, as shown in the README example request.
- Send a chat request to
curl -s $GATEWAY/v1/chat/completionswith the tenant key as the Bearer token.
These steps come from our top use case, Send all app AI calls through one OpenAI-style endpoint, which also has a copy-paste agent prompt.
Get 5 new use cases every morning. Free, one short email, unsubscribe anytime.
Get them freeSynapass alternatives · Best AI repos for Software and DevOps
About this repo
- Who it is forPlatform engineers and developers who run several AI model providers and want one endpoint, central cost control, and a record of why each request was routed where it was.
- Why it is hot
- LanguageGo
- Sourcegithub.com/ShadowSafin/Synapass · Back to Hot repos
Requirements
- Docker with Docker Compose, curl, and jq, or Go and Make for the native build
- At least one provider API key such as OPENAI_API_KEY or ANTHROPIC_API_KEY in .env
- A host with ports 8080 and 3000 free, or a changed GATEWAY_PORT
Maintain Synapass? Add the Featured on Deduped badge
Paste this into your README:
[](https://dedupedai.com/use-cases/shadowsafin-synapass/?ref=badge)
Questions about Synapass
What is Synapass?
Synapass is an open-source OpenAI-compatible gateway and control plane that routes each AI request to a provider under policy, handles failover, caching, budgets, and request tracing. It is an open-source project on GitHub: https://github.com/ShadowSafin/Synapass.
Who is Synapass for?
Platform engineers and developers who run several AI model providers and want one endpoint, central cost control, and a record of why each request was routed where it was.
What can I do with Synapass?
4 use cases so far, for example: Send all app AI calls through one OpenAI-style endpoint; Trace which provider and policy handled a bad AI answer; Set spending limits so one team cannot run up the AI bill. Each has steps and a copy-paste agent prompt.
What do I need to run Synapass?
Docker with Docker Compose, curl, and jq, or Go and Make for the native build; At least one provider API key such as OPENAI_API_KEY or ANTHROPIC_API_KEY in .env; A host with ports 8080 and 3000 free, or a changed GATEWAY_PORT.
What are alternatives to Synapass?
Other hot AI repos in Software and DevOps: Harness2, iFixAi, Orca, Diagram Design, AI Memory.
Is Synapass safe to run?
Deduped does not own, audit or vouch for it. Read the README and license, run it on your own systems first and review every command before you run it.