# namansoni78/pollinations architecture

> Architecture diagram of the GitHub repository namansoni78/pollinations, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/namansoni78/pollinations
- Repository: https://github.com/namansoni78/pollinations

## Overview

Pollinations is an open-source generative AI platform centered on a unified API for text, image, audio, video, 3D, and embeddings. The principal workflow is: a developer obtains an API key through the account dashboard, sends a generation request to the API, and receives generated output. The repository also includes client tooling, MCP integrations, a public website, and operational dashboards. Several subsystem links below reflect README-documented capabilities; source excerpts are limited, so undocumented internal routing and provider dispatch are not inferred.

Main entry points: [`gen.pollinations.ai/src`](https://github.com/namansoni78/pollinations/tree/main/gen.pollinations.ai/src) (Unified API), [`enter.pollinations.ai/frontend/src/routes/_dashboard.tsx`](https://github.com/namansoni78/pollinations/blob/main/enter.pollinations.ai/frontend/src/routes/_dashboard.tsx) (Account Dashboard), [`gen.pollinations.ai/src/model3d/models/inferenceportClient.ts`](https://github.com/namansoni78/pollinations/blob/main/gen.pollinations.ai/src/model3d/models/inferenceportClient.ts) (3D Generation), [`packages/mcp/src/server.js`](https://github.com/namansoni78/pollinations/blob/main/packages/mcp/src/server.js) (MCP Server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_generation["Generation API"]
  node_gen_api["Unified API<br/>[src]"]
  node_image["Image Generation<br/>[handler.ts]"]
  node_text["Text Generation"]
  node_model3d["3D Generation"]
  node_other_modalities["Other Modalities<br/>[src]"]
  node_providers{{"External Providers"}}
end

subgraph group_accounts["Accounts and Billing"]
  node_enter["Account Dashboard<br/>[_dashboard.tsx]"]
  node_auth_api["Account Services<br/>[index.ts]"]
  node_billing["Pollen Billing<br/>[stripe.ts]"]
  node_keys["API Keys<br/>[api-keys.ts]"]
end

subgraph group_clients["Clients and Integrations"]
  node_sdk["JavaScript SDK<br/>[client.ts]"]
  node_mcp["MCP Server<br/>[server.js]"]
  node_embeddings_tool["Embedding Tool"]
  node_cli["CLI"]
end

subgraph group_product["Web Products"]
  node_website["Pollinations Website<br/>[App.tsx]"]
  node_community_apps["Community Apps"]
  node_model_monitor["Model Monitor<br/>[App.jsx]"]
  node_economics["Economics Dashboard<br/>[App.tsx]"]
end

node_developer(("Developer"))

node_developer -->|"gets started"| node_enter
node_enter -.->|"manages account"| node_auth_api
node_enter -.->|"manages keys"| node_keys
node_enter -.->|"manages credits"| node_billing
node_developer -->|"requests generation"| node_gen_api
node_gen_api -.->|"dispatches"| node_image
node_gen_api -.->|"dispatches"| node_text
node_gen_api -.->|"dispatches"| node_model3d
node_gen_api -->|"supports"| node_other_modalities
node_model3d -->|"submits jobs"| node_providers
node_developer -->|"integrates with"| node_sdk
node_developer -->|"connects agents"| node_mcp
node_mcp -.->|"registers tool"| node_embeddings_tool
node_embeddings_tool -->|"posts embeddings"| node_gen_api
node_developer -->|"uses CLI"| node_cli
node_developer -->|"discovers products"| node_website
node_gen_api -->|"powers projects"| node_community_apps
node_developer -.->|"monitors models"| node_model_monitor
node_developer -.->|"reviews economics"| node_economics

click node_gen_api "https://github.com/namansoni78/pollinations/tree/main/gen.pollinations.ai/src"
click node_image "https://github.com/namansoni78/pollinations/blob/main/gen.pollinations.ai/src/image/handler.ts"
click node_text "https://github.com/namansoni78/pollinations/blob/main/gen.pollinations.ai/src/text/azureResponsesClient.ts"
click node_model3d "https://github.com/namansoni78/pollinations/blob/main/gen.pollinations.ai/src/model3d/models/inferenceportClient.ts"
click node_other_modalities "https://github.com/namansoni78/pollinations/tree/main/gen.pollinations.ai/src"
click node_enter "https://github.com/namansoni78/pollinations/blob/main/enter.pollinations.ai/frontend/src/routes/_dashboard.tsx"
click node_auth_api "https://github.com/namansoni78/pollinations/blob/main/enter.pollinations.ai/src/index.ts"
click node_billing "https://github.com/namansoni78/pollinations/blob/main/enter.pollinations.ai/src/routes/stripe.ts"
click node_keys "https://github.com/namansoni78/pollinations/blob/main/enter.pollinations.ai/src/routes/api-keys.ts"
click node_website "https://github.com/namansoni78/pollinations/blob/main/pollinations.ai/src/App.tsx"
click node_sdk "https://github.com/namansoni78/pollinations/blob/main/packages/sdk/src/client.ts"
click node_mcp "https://github.com/namansoni78/pollinations/blob/main/packages/mcp/src/server.js"
click node_embeddings_tool "https://github.com/namansoni78/pollinations/blob/main/packages/mcp/src/services/embeddingService.js"
click node_cli "https://github.com/namansoni78/pollinations/tree/main/packages/polli-cli"
click node_community_apps "https://github.com/namansoni78/pollinations/tree/main/apps"
click node_model_monitor "https://github.com/namansoni78/pollinations/blob/main/operations/model-monitor/src/App.jsx"
click node_economics "https://github.com/namansoni78/pollinations/blob/main/operations/economics/web/src/App.tsx"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_gen_api,node_image,node_text,node_model3d,node_other_modalities,node_providers toneBlue
class node_enter,node_auth_api,node_billing,node_keys toneAmber
class node_sdk,node_mcp,node_embeddings_tool,node_cli toneMint
class node_website,node_community_apps,node_model_monitor,node_economics toneRose
class node_developer toneIndigo
```

## Components

### Generation API

- [Unified API](https://github.com/namansoni78/pollinations/tree/main/gen.pollinations.ai/src): `gen.pollinations.ai/src`
- [Image Generation](https://github.com/namansoni78/pollinations/blob/main/gen.pollinations.ai/src/image/handler.ts): `gen.pollinations.ai/src/image/handler.ts`
- [Text Generation](https://github.com/namansoni78/pollinations/blob/main/gen.pollinations.ai/src/text/azureResponsesClient.ts): `gen.pollinations.ai/src/text/azureResponsesClient.ts`
- [3D Generation](https://github.com/namansoni78/pollinations/blob/main/gen.pollinations.ai/src/model3d/models/inferenceportClient.ts): `gen.pollinations.ai/src/model3d/models/inferenceportClient.ts`
- [Other Modalities](https://github.com/namansoni78/pollinations/tree/main/gen.pollinations.ai/src): `gen.pollinations.ai/src`
- **External Providers**

### Accounts and Billing

- [Account Dashboard](https://github.com/namansoni78/pollinations/blob/main/enter.pollinations.ai/frontend/src/routes/_dashboard.tsx): `enter.pollinations.ai/frontend/src/routes/_dashboard.tsx`
- [Account Services](https://github.com/namansoni78/pollinations/blob/main/enter.pollinations.ai/src/index.ts): `enter.pollinations.ai/src/index.ts`
- [Pollen Billing](https://github.com/namansoni78/pollinations/blob/main/enter.pollinations.ai/src/routes/stripe.ts): `enter.pollinations.ai/src/routes/stripe.ts`
- [API Keys](https://github.com/namansoni78/pollinations/blob/main/enter.pollinations.ai/src/routes/api-keys.ts): `enter.pollinations.ai/src/routes/api-keys.ts`

### Clients and Integrations

- [JavaScript SDK](https://github.com/namansoni78/pollinations/blob/main/packages/sdk/src/client.ts): `packages/sdk/src/client.ts`
- [MCP Server](https://github.com/namansoni78/pollinations/blob/main/packages/mcp/src/server.js): `packages/mcp/src/server.js`
- [Embedding Tool](https://github.com/namansoni78/pollinations/blob/main/packages/mcp/src/services/embeddingService.js): `packages/mcp/src/services/embeddingService.js`
- [CLI](https://github.com/namansoni78/pollinations/tree/main/packages/polli-cli): `packages/polli-cli`

### Web Products

- [Pollinations Website](https://github.com/namansoni78/pollinations/blob/main/pollinations.ai/src/App.tsx): `pollinations.ai/src/App.tsx`
- [Community Apps](https://github.com/namansoni78/pollinations/tree/main/apps): `apps`
- [Model Monitor](https://github.com/namansoni78/pollinations/blob/main/operations/model-monitor/src/App.jsx): `operations/model-monitor/src/App.jsx`
- [Economics Dashboard](https://github.com/namansoni78/pollinations/blob/main/operations/economics/web/src/App.tsx): `operations/economics/web/src/App.tsx`

### Other components

- **Developer**

## Connections

- Developer → Account Dashboard: gets started (evidence: `README.md`)
- Account Dashboard → Account Services: manages account
- Account Dashboard → API Keys: manages keys
- Account Dashboard → Pollen Billing: manages credits
- Developer → Unified API: requests generation (evidence: `README.md`)
- Unified API → Image Generation: dispatches
- Unified API → Text Generation: dispatches
- Unified API → 3D Generation: dispatches (evidence: `gen.pollinations.ai/src/model3d/models/inferenceportClient.ts`)
- Unified API → Other Modalities: supports (evidence: `README.md`)
- 3D Generation → External Providers: submits jobs (evidence: `gen.pollinations.ai/src/model3d/models/inferenceportClient.ts`)
- Developer → JavaScript SDK: integrates with (evidence: `README.md`)
- Developer → MCP Server: connects agents (evidence: `README.md`)
- MCP Server → Embedding Tool: registers tool
- Embedding Tool → Unified API: posts embeddings (evidence: `packages/mcp/src/services/embeddingService.js`)
- Developer → CLI: uses CLI (evidence: `README.md`)
- Developer → Pollinations Website: discovers products (evidence: `README.md`)
- Unified API → Community Apps: powers projects (evidence: `README.md`)
- Developer → Model Monitor: monitors models
- Developer → Economics Dashboard: reviews economics
