GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — GitHub - pollinations/pollinations: Your Friendly Open-Source Gen-AI Platform

BranchesTags
Open more actions menu

Latest commit

 

History

12,706 Commits
12,706 Commits

Folders and files

NameName
Last commit message
Last commit date
.agents/skills
.agents/skills
 
 
.claude
.claude
 
 
.github
.github
 
 
.oss-scanner
.oss-scanner
 
 
.vscode
.vscode
 
 
apps
apps
 
 
enter.pollinations.ai
enter.pollinations.ai
 
 
gen.pollinations.ai
gen.pollinations.ai
 
 
media.pollinations.ai
media.pollinations.ai
 
 
operations
operations
 
 
packages
packages
 
 
pollinations.ai
pollinations.ai
 
 
shared
shared
 
 
.dockerignore
.dockerignore
 
 
.gitattributes
.gitattributes
 
 
.gitignore
.gitignore
 
 
.sops.yaml
.sops.yaml
 
 
AGENTS.md
AGENTS.md
 
 
APIDOCS.md
APIDOCS.md
 
 
BRING_YOUR_OWN_MODEL.md
BRING_YOUR_OWN_MODEL.md
 
 
BRING_YOUR_OWN_POLLEN.md
BRING_YOUR_OWN_POLLEN.md
 
 
BUILD_YOUR_OWN_AGENT.md
BUILD_YOUR_OWN_AGENT.md
 
 
CLAUDE.md
CLAUDE.md
 
 
CODE_OF_CONDUCT.md
CODE_OF_CONDUCT.md
 
 
CODING_HARNESSES.md
CODING_HARNESSES.md
 
 
CONTRIBUTING.md
CONTRIBUTING.md
 
 
DEVELOP.md
DEVELOP.md
 
 
LICENSE
LICENSE
 
 
README.md
README.md
 
 
SECURITY.md
SECURITY.md
 
 
biome.jsonc
biome.jsonc
 
 
context7.json
context7.json
 
 
funding.json
funding.json
 
 
package-lock.json
package-lock.json
 
 
package.json
package.json
 
 
skills-lock.json
skills-lock.json
 
 

Repository files navigation

pollinations.ai

Open-source AI for people who make things.

Stars License Discord

Website · Dashboard · Playground · Guides · API Docs · For AI Agents · Discord

Pixel art cozy hackerspace: robot at terminal, nomnom creature eating code, bee with glasses

🆕 Recent Apps

Name Description Author
✍️ Voiceprint Map the recognizable LLM voice in any passage, inspect six concrete style markers, and rewrite it with a more specific human cadence using Pollinations. Includes a zero-Pollen local scan. @ismailbanouigu
💬 Ask Them All Ask one question and several labs answer it in parallel through a single Pollinations key, side by side, with a summary of where they agree and differ. @mhmdrizzzki
🎮 Vaultwright A heist game AI agents play over a remote MCP server: five locks a day, an alarm budget, a signed handle, and a live spectator board. Pollinations writes the hints. @rekty
🎮 Empty Room Three AI agents in a plain room with nothing to do. Each turn they speak and act; drop an object in and watch what they make of it. The page checks every move. @rekty
🖼️ Cover Story Hides a message in a picture's pixels with a checksum, then Pollinations writes the innocent caption for posting it and reads the note back. Own Pollen. No build step, tested. @rekty
📚 Phenomena Lab Turn any science topic into a clickable systems map, four explorable scenes and a prediction quiz. Uses GPT-5.4 Nano through Bring Your Own Pollen; includes a full offline demo. @ismailbanouigu
📚 Unfold Name a science topic and a Pollinations model draws it: parts, links and the steps that read the figure. Walk the diagram step by step, or click a part and ask about it. @Sugamdeol
🎮 Model Machine A computer with no CPU: a Pollinations model returns each next machine state, one instruction per call, while a reference core runs beside it to show where it drifts. @Sugamdeol
📚 Pixel Letter Pollinations LLM-designed PNG postcards with locally hidden messages, optional AES-GCM encryption and OAuth BYOP. Secrets stay on the device; recipients decode without API calls. Includes a free demo. @CristopherSalazar
💬 Crosscheck Ask multiple Pollinations text models the same question. Compare their answers side by side, vote before revealing identities, and pay with your own Pollen. @Chappoo974

Browse all apps →

🚀 Unified API

https://gen.pollinations.ai provides one API for text, images, audio, video, 3D, and embeddings.

What's Included

  • Unified endpoint: single API at gen.pollinations.ai for all generation
  • Pollen credits: simple pay-as-you-go system ($1 ≈ 1 Pollen)
  • All models, one place: Flux, GPT, Claude, Gemini, Seedream, and more
  • API keys: secret keys for model usage, app keys for tracking BYOP apps.
  • CLI: npx @pollinations/cli for humans and AI agents (source)
  • Agent discovery: gen.pollinations.ai/llms.txt indexes the CLI skill, MCP server catalog, OpenAPI schema, and Agent Skills in one request

Get started at enter.pollinations.ai and check out the API docs

🆕 Latest News

  • Feature Choose a sandbox template Nov 11
    Compare sandbox templates by provider, size, hourly price, and Quest eligibility, then open creation with your choice selected. The Sandboxes page also shows running and paused states more clearly.
  • Feature Inspect media before editing Nov 11
    Use the FFmpeg MCP tool probeMedia to inspect one public HTTPS media URL before choosing runFfmpeg arguments. It returns format and stream metadata as JSON, including duration, codecs, resolution, bitrate, and frame rate.
  • Feature Hash text in MCP Nov 11
    The calculators MCP tool hash_text hashes UTF-8 text locally and returns lowercase hex and base64 digests. It uses SHA-256 by default; SHA-1 is available for checksum compatibility.
  • Feature Pick a decision model Nov 11
    Ask Jev's jev_decide tool now accepts an optional model argument. Choose an accessible model that lists /alpha/decisions as a supported endpoint, or omit it to use the default Jev model.
  • Feature Look up RubyGems Nov 11
    The packages MCP tool package_lookup now fetches the current version of a Ruby gem or an exact version you specify. Results include dependencies, license, download counts, and yank status.
  • Model ElevenLabs SFX v3 Nov 10
    Generate MP3 sound effects from text with elevenlabs/eleven-text-to-sound-v3. Set duration, looping, and prompt influence. Paid access is required.
  • Model Scribe v3 batch transcription Nov 10
    Transcribe audio with elevenlabs/scribe-v3, including word timestamps and speaker labels in supported response formats. Paid access is required.
  • Model Scribe v3 Live transcription Nov 10
    Use elevenlabs/scribe-v3-live for realtime transcription sessions with incremental and final transcripts. Paid access is required.
  • Model Gemini Omni 1.2 Flash video Nov 9
    Generate paid videos with google/gemini-omni-1.2-flash from text or up to two reference images. It supports start and end frames, synchronized audio, and 3 to 15 second output from 360p through 4K.
  • Model Longer Wan 3.0 videos Nov 9
    Choose any duration from 2 to 15 seconds for Wan 3.0 videos made from text, frames, or reference media. The default stays at 5 seconds.

More news on enter.pollinations.ai →


🌱 Introduction

pollinations.ai is an open-source generative AI platform based in Berlin, used by 500+ community projects. It provides APIs for text, image, video, audio, 3D, and embeddings generation. Our code and development discussions are public. Supporters help fund the project.

Star History Chart

🚀 Key Features

  • 🔓 100% Open Source: code, decisions, roadmap all public
  • 🤝 Community-Built: 500+ projects already using our APIs
  • 🌱 Pollen Quests: earn Pollen by completing Quests
  • 🖼️ Image Generation: Text-to-image and image editing
  • 📝 Text Generation: Chat, reasoning, vision, function calling, structured outputs
  • 🎬 Video Generation: Text-to-video and image-to-video
  • 🎵 Audio: Text-to-speech and speech-to-text
  • 🧊 3D Generation: Text-to-3D and image-to-3D
  • 🎙️ Real-time API: OpenAI-compatible WebSocket for streaming conversations
  • 🔢 Embeddings Creation: Semantic search, retrieval, similarity matching
  • 🤖 Managed Agents: Turn a prompt, base model, and optional Pollinations tools into a reusable model
  • 📦 Sandboxes: Cloud Linux computers for you or your agents, opened with SSH or VS Code
  • 🌐 Sites: Free static hosting at <name>.pollinations.app
  • 🎣 Easy-to-use Packages (Packages)

Guides

Guide Purpose
Pollinations Pay (BYOP) Let users pay with their own Pollen
Publish an Agent Publish a hosted agent
Publish a Model Connect your model endpoint
Sandboxes Run code in a virtual machine
Sites Host a static site at .pollinations.app
Coding Harnesses Connect a coding assistant
MCP Servers Give agents access to tools
CLI Use Pollinations from a terminal

🤖 Managed Agents

Build a reusable text agent without hosting an agent server. Choose a system prompt and base model, optionally give it Pollinations tools, then call it through the same OpenAI-compatible API as any other model.

  • Private or public: keep an agent owner-only or publish it after receiving community publisher access.
  • Normal model API: call a registered agent by its owner/agent-name model ID.
  • Dashboard, CLI, or API: manage agents in My Models, with polli agents, or through /account/agents.

See Publish an Agent for setup and billing behavior.

🛠️ Coding Harnesses

Run tools such as Bloom CLI, DeepSeek Harness, Hermes Agent, Mistral Vibe, OpenCode, Pi, Prime Agent, and tgpt on Pollinations models. polli harness edits the tool's own config so it calls Pollinations with a dedicated key, and restores it on off.

npx @pollinations/cli harness dsh on

See Coding Harnesses for supported harnesses and how to add one.

🧩 Community Models

Community members connect their own OpenAI-compatible text, image, image-editing, and speech-to-text endpoints to Pollinations.

  • Host your own model: follow Publish a Model to test and register an upstream endpoint, then keep it private or publish it to the catalog.
  • Automatic fallback routing: nominate up to three compatible backup models so generations keep moving when an upstream model goes down.
  • Discover and monitor: browse community models via gen.pollinations.ai/v1/models and watch live health and community leaderboards at model-monitor.pollinations.ai.

For billing details when building apps on top, see Pollinations Pay.

🚀 Getting Started

Ask DeepWiki

Quick Start (3 Steps)

1️⃣ Get your API key
Sign up at enter.pollinations.ai to generate your key.

2️⃣ Choose what you want to generate
Pollinations supports:

  • 🖼 Images
  • 📝 Text
  • 🔊 Audio
  • 🎬 Video
  • 🧊 3D
  • 🔢 Embeddings

3️⃣ Make your first request
Use one of the examples below to generate your first AI output in seconds.

Image Generation

curl -H "Authorization: Bearer YOUR_API_KEY" 'https://gen.pollinations.ai/image/a%20beautiful%20sunset' -o image.jpg

Or visit pollinations.ai/play for an interactive experience.

Text Generation

curl 'https://gen.pollinations.ai/text/Hello%20world?key=YOUR_API_KEY'

Audio Generation

Simple GET endpoint:

curl 'https://gen.pollinations.ai/audio/Hello%20from%20Pollinations?voice=nova&key=YOUR_API_KEY' -o speech.mp3

OpenAI TTS compatible:

curl 'https://gen.pollinations.ai/v1/audio/speech' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{"model": "openai/tts-1", "input": "Hello from Pollinations!", "voice": "nova"}' \
  -o speech.mp3

Available voices: alloy, echo, fable, onyx, nova, shimmer, plus 30+ ElevenLabs voices.

Speech-to-text:

curl 'https://gen.pollinations.ai/v1/audio/transcriptions' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F [email protected] \
  -F model=openai/whisper-large-v3

Video Generation

curl 'https://gen.pollinations.ai/video/a%20sunset%20timelapse%20over%20the%20ocean?key=YOUR_API_KEY' -o video.mp4

Use duration to set video length, aspectRatio for orientation, and image[0]/image[1] to pass start/end reference frames. See available video models and capabilities at gen.pollinations.ai/video/models.

3D Generation

curl 'https://gen.pollinations.ai/3d/a%20low-poly%20treasure%20chest?model=microsoft/trellis-2&resolution=low&key=YOUR_API_KEY&image=IMAGE_URL' -o model.glb

Pass reference image URL(s) via the image parameter for image-to-3D models (put image= last in the URL, or URL-encode it). See available 3D models at gen.pollinations.ai/3d/models.

Embeddings

curl 'https://gen.pollinations.ai/v1/embeddings' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{"model": "openai/text-embedding-3-small", "input": "Hello world!"}'

Pass a string or an array of up to 32 strings (text or multimodal content parts). See available embedding models at gen.pollinations.ai/embeddings/models.

Pollinations CLI

Generate text, images, audio, video, and more right from your terminal:

npx @pollinations/cli gen image "cyberpunk city at night" --model black-forest-labs/flux.1-schnell --output city.png
npx @pollinations/cli gen text "Explain quantum tunneling in one sentence"
npx @pollinations/cli gen audio "Hello world" --voice nova --output speech.mp3
npx @pollinations/cli gen video "a waterfall in slow motion" --duration 5 --output clip.mp4
npx @pollinations/cli gen transcribe speech.mp3

Install globally and use the shorter polli command: npm install -g @pollinations/cli. Run polli models to list models, polli auth login to authenticate, and polli docs for the full API reference in your terminal.

Real-time API

Stream AI responses over an OpenAI-compatible WebSocket:

wss://gen.pollinations.ai/v1/realtime?model=openai/gpt-realtime-2.1&key=sk_YOUR_API_KEY

Browser clients pass a user-authorized key from Pollinations Pay as a query parameter (?key=); server clients can use the Authorization: Bearer header instead.

MCP Servers

Connect Streamable HTTP clients to the hosted Pollinations MCP server:

https://gen.pollinations.ai/mcp/pollinations

Send your Pollinations API key as an Authorization: Bearer header. See the MCP Servers documentation for the full hosted catalog.

🔐 Authentication

Get your API key at enter.pollinations.ai

Key Types

Key Prefix Use Case Rate Limits Status
App Key pk_ Identifies your app in Pollinations Connect Can't authenticate requests Stable
Secret sk_ Server-side only No rate limits Stable

⚠️ Never expose sk_ keys in client-side code, git repos, or public URLs

💡 Building an app? Use Pollinations Pay: users pay for their own usage, you pay $0

Model Restrictions

Each API key can be scoped to model categories or specific models. When creating a key at enter.pollinations.ai, you can:

  • Allow all models: key works with any available model
  • Restrict to categories: e.g. only image, or image and text. A key allows every model in its categories, including models added later
  • Restrict to specific models: through the API or polli keys update <id> --models black-forest-labs/flux.1-schnell tongyi-mai/z-image-turbo; a model ID allows only that model

Usage

curl 'https://gen.pollinations.ai/image/a%20cat?key=YOUR_KEY'

Environment variable (best practice):

export POLLINATIONS_API_KEY=sk_...

See full API docs for detailed authentication information.

🖥️ How to Use

Web Interface

Visit the playground to generate content in your browser.

Here are some examples of what you can generate:

Pixel art robot and bee in a cozy digital garden: Stardew Valley style

Robot holding generated image saying I CAN SEE, nomnom creature eating prompt text

🛠️ Integration

SDK

Check out our Pollinations SDK for Node.js, browser, and React integration.

OpenAI SDK Compatibility

The API is OpenAI-compatible. Set the base URL in an official OpenAI SDK to https://gen.pollinations.ai/v1.

Node.js:

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://gen.pollinations.ai/v1",
  apiKey: "YOUR_API_KEY",
});

const response = await client.chat.completions.create({
  model: "openai/gpt-5.4-nano",
  messages: [{ role: "user", content: "Hello!" }],
});
console.log(response.choices[0].message.content);

Python:

from openai import OpenAI

client = OpenAI(base_url="https://gen.pollinations.ai/v1", api_key="YOUR_API_KEY")

response = client.chat.completions.create(
    model="openai/gpt-5.4-nano",
    messages=[{"role": "user", "content": "Hello!"}],
)
print(response.choices[0].message.content)

Other OpenAI SDKs work too: Go, Java, .NET, Rust (async-openai, community), plus compatible frameworks like Vercel AI SDK.

Vercel AI SDK:

import { createOpenAICompatible } from "@ai-sdk/openai-compatible";
import { generateText } from "ai";

const pollinations = createOpenAICompatible({
  name: "pollinations",
  baseURL: "https://gen.pollinations.ai/v1",
  apiKey: "YOUR_API_KEY",
});

const { text } = await generateText({
  model: pollinations.chatModel("openai/gpt-5.4-nano"),
  prompt: "Hello!",
});
console.log(text);

Streaming, image, and embedding examples: API docs → Vercel AI SDK.

Architecture

%%{init: {'theme': 'dark', 'themeVariables': { 'background': '#1a1a1a', 'primaryColor': '#2a2a2a', 'primaryBorderColor': '#555555', 'primaryTextColor': '#eeeeee', 'lineColor': '#00e5ff', 'clusterBkg': 'transparent', 'clusterBorder': '#888888', 'fontSize': '13px', 'fontFamily': 'Inter, system-ui, sans-serif'}}}%%

graph LR
    subgraph CLIENTS["Clients / Apps"]
        Q[Bots - Discord, Telegram, WhatsApp]
        N[30+ Mobile and Web Apps]
        A[pollinations.ai Web Frontend]
        R[AI Agents - Qwen, Sillytavern, ...]
        AI[AI Assistants - Claude]
        MCP[MCP Server]
    end

    AI --> MCP
    Q --> GEN
    N --> GEN
    A --> GEN
    R --> GEN
    MCP --> GEN

    GEN["gen.pollinations.ai: Edge Router + Generation Worker"]:::cfWorker -->|auth and billing| ENTER["enter.pollinations.ai: Auth Gateway + Billing"]:::cfWorker

    GEN --> IMG["Image: gen Worker dispatch to providers / GPU backends"]:::cfWorkerLight
    IMG --> D["Flux, Z-Image, Seedream, ...: GPU VMs"]:::gpuNode

    GEN --> TXT["Text: Portkey multi-provider"]:::provider
    GEN --> VID["Video: Wan / Veo / Seedance"]:::provider
    GEN --> AUD["Audio: ElevenLabs / OVH (Whisper)"]:::provider

    style CLIENTS fill:none,stroke:#888,stroke-width:2px,stroke-dasharray: 5 5

    linkStyle default stroke-width:3px,stroke:#00E5FF

    classDef cfWorker fill:#E65100,color:#fff,stroke:#FFB300,stroke-width:2px,font-weight:bold
    classDef cfWorkerLight fill:#BF360C,color:#fff,stroke:#FFB300,stroke-width:1px
    classDef gpuNode fill:#064E3B,stroke:#34D399,color:#ECFDF5,stroke-width:2px
    classDef provider fill:#1E3A8A,stroke:#60A5FA,color:#EFF6FF,stroke-width:1px
Loading

🔮 Future Developments

We're exploring:

  • Digital Twins: Creating interactive AI-driven avatars
  • Music Video Generation: Combining AI-generated visuals with music
  • Real-time AI-driven Visual Experiences: Projects like our Dreamachine

🌍 Our Vision

We want AI tools to be:

  • Open & Accessible: Earn Pollen by contributing, without a credit card

  • Transparent & Ethical: Inspect our code and discuss how the platform works

  • Community-Driven: Build tools with other developers, creators, and AI enthusiasts

  • Interconnected: Combine models and services through shared APIs

  • Evolving: Add new capabilities while keeping the platform open and accessible

🤝 Community and Development

You can contribute to pollinations.ai in several ways:

  1. Coding Assistant: Create a GitHub issue describing a feature for the Polli assistant to work on. You can propose a change without writing code.

  2. Project Submissions: Have you built something with pollinations.ai? Use our app submission template to share it with the community and get it featured in our README.

  3. Feature Requests & Bug Reports: Have an idea or found a bug? Open an issue and let us know. Our team and the Polli assistant will review it.

  4. Community Engagement: Join our Discord community to:

    • Share your creations
    • Get support and help others
    • Collaborate with fellow AI enthusiasts
    • Discuss feature ideas before creating issues

For any questions or support, please visit our Discord channel or create an issue on our GitHub repository.

🗂️ Project Structure

The main folders are:

  • pollinations.ai/: The main React application for the Pollinations.ai website.

  • gen.pollinations.ai/: Cloudflare Worker for API routing, auth handoff, text generation, and caching.

  • enter.pollinations.ai/: Auth gateway and billing: API keys, Pollen credits, and pack checkout.

  • shared/: Auth, model registries, IP queue, and utilities shared across the services.

  • apps/: Applications maintained in this repository.

  • operations/: Internal dashboards, monitoring, economics, and infrastructure, including the GPU fleet.

  • media.pollinations.ai/: Media upload service: upload files and get a URL to use with Pollinations models, with public tag galleries.

  • operations/news/: Automated social media pipeline (X, LinkedIn, Instagram, Reddit, Discord).

  • packages/polli-cli/: The Pollinations CLI for people and AI agents.

  • packages/sdk/: SDK NPM library with pollinations ready functions for Pollinations.ai.

  • packages/mcp/: Model Context Protocol (MCP) server for AI assistants like Claude to generate images directly.

  • opencode-pollinations-plugin: A community plugin that connects OpenCode to Pollinations models, built by @fkom13.

For development setup and environment management, see DEVELOP.md.

🏢 Supported By

pollinations.ai is supported by:

Pixel art garden shelf: supporter plants in labeled pots, robot watering, bee with watering can

  • Perplexity AI: AI-powered search and conversational answer engine
  • AWS Activate: GPU Cloud Credits
  • io.net: Decentralized GPU network for AI compute
  • BytePlus: Official ByteDance cloud services and AI solutions
  • Google Cloud for Startups: GPU Cloud Credits
  • NVIDIA Inception: AI startup support
  • Azure (MS for Startups): OpenAI credits
  • Cloudflare: Put the connectivity cloud to work for you.
  • Scaleway: Europe's empowering cloud provider
  • Modal: High-performance AI infrastructure
  • Nebius: AI-optimized cloud infrastructure with NVIDIA GPU clusters
  • OpenAI: Frontier AI models and APIs
  • OpenRouter: Unified API for LLMs
  • Fireworks AI: Fast inference platform for open models
  • Replicate: Run AI models with an API
  • RunPod: GPU cloud built for AI workloads
  • OVHcloud: European cloud and GPU infrastructure
  • Lambda Labs: GPU cloud for AI training and inference
  • ElevenLabs: AI voice generation and text-to-speech
  • AssemblyAI: Speech-to-text and speech understanding models
  • Alibaba Cloud: Cloud computing and AI services

💚 Support Us

The best way to support pollinations.ai is by using our product! Get your API key and start building at enter.pollinations.ai.

📣 Stay Connected

Status · News & FAQ · 𝕏 Twitter · Instagram · LinkedIn · Facebook · Reddit · YouTube

📜 License

pollinations.ai is open-source software licensed under the MIT license.


Made with ❤️ by the pollinations.ai team

About

Your Friendly Open-Source Gen-AI Platform

pollinations.ai

Topics

colaboratorycolaboratory-notebookdiffusiongangenerativegsochacktoberfest-acceptedhacktoberfest2025javascriptmachinelearningnodejspythontypescript

Resources

Readme
MIT license

Code of conduct

Code of conduct

Contributing

Contributing

Security policy

Security policy
Activity
Custom properties

Stars

5.3k stars

Watchers

49 watching

Forks

1.2k forks
Report repository

Releases

Packages

Used by

Contributors

Languages

You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.