Skip to main content

Integrations

Overview:

  • ChyperAI integrates with external providers and tools to extend automation and AI workflows.
  • Integration metadata is managed in public/config/integrations.json.

Core integrations:

  • LLM Providers: OpenAI, Anthropic, OpenRouter, DeepSeek
  • Source Control: GitHub OAuth (client-side via Clerk + server-side callbacks)
  • Storage/DB: Cloudflare D1
  • Runtime: Cloudflare Pages Functions, Workers, Durable Objects

How to add an integration:

  1. Update public/config/integrations.json with display name, categories, and docs link.
  2. Add credentials as Cloudflare Pages Secrets where applicable.
  3. Document usage and required environment variables in the docs site.
  4. If UI components are needed, add them under app/components/integrations.

Environment variables & secrets:

  • Pages Vars (non-sensitive): VITE_* keys
  • Pages Secrets (sensitive): ANTHROPIC_API_KEY, OPENROUTER_API_KEY, DEEPSEEK_API_KEY, GITHUB_CLIENT_SECRET

Example JSON snippet:

{
  "providers": [
    { "id": "openai", "name": "OpenAI", "docs": "/docs/platform/integrations#openai" },
    { "id": "anthropic", "name": "Anthropic", "docs": "/docs/platform/integrations#anthropic" }
  ]
}

LLM configuration tips:

  • Prefer per-tenant scoping of keys via secrets + runtime lookup.
  • Implement provider fallbacks and rate limits.
  • Log model, tokens, and error codes for observability.