🌸 Pollinations AI Plugin for OpenCode (v5.9.0)

📖 Philosophy: Open AI for Creators

"No closed doors, no corporate hoops — just good tools and good people."

Pollinations.ai is an open-source platform built by and for the community. We provide a unified API for image, text, audio, and video generation.

• Transparent: Our code, roadmap, and discussions are open.
• Community Driven: Features are prioritized based on what you need.
• Fair: One single currency (Pollen) for all models. No complex subscriptions.

📸 Gallery

✨ Features

• 🌍 Free Universe: Access generic models (openai, mistral, gemini) for FREE, unlimited time, no API key required.
• 🚀 Pro Mode: Connect your Pollinations API Key to access Premium Models (claude-3-opus, gpt-4o, deepseek-coder).
• 🔐 Limited Key Support (v5.6.0): Use keys restricted to "Generation Only". The plugin automatically disables Advanced Features (Dashboard/Quota) but allows full generation in Manual Mode.
• 🛡️ Safety Net V5: never get blocked.
  • Transparent Fallback: If your Pro quota runs out mid-chat, the plugin automatically switches to a free model instantly. No errors, just a seamless experience.
  • Smart Mode Switching: Prevents Limited Keys from entering "Pro" mode to avoid confusing errors.
• 📊 Real-time Dashboard: Track your Pollen usage, Tier Status, and Wallet Balance inside OpenCode.
• 🔇 Stealth Mode (v5.4.7): Status notifications are now strictly limited to Pollinations Enter (Paid) sessions. No more cluttered notifications when using other providers like Nvidia or Google AI.

🐝 Understanding Pollen & Tiers

Pollen is our unified credit system. $1 ≈ 1 Pollen. You spend it to verify API calls on premium models.

Tiers (Free Daily Grants during Beta)

| Tier | Grant | Requirement | | :--- | :--- | :--- | | 🦠 Spore | 1 Pollen/day | Just Sign Up! | | 🌱 Seed | 3 Pollen/day | Active GitHub Developer (8+ points) | | 🌸 Flower | 10 Pollen/day | Publish an App (Like this Plugin!) | | 🍯 Nectar | 20 Pollen/day | Major Contributors (Coming Soon) |

🎁 Beta Bonus: Buy one Pollen pack, get one free!

🐧 Platform Support & Dynamic Ports (v5.4.6+)

This plugin is true Cross-Platform (Windows, macOS, Linux).

• Dynamic Port Allocation: No more port conflicts! The plugin automatically finds an available port on startup.
• Tools Support: Using tools with Gemini (Free) triggers an Automatic Intelligent Fallback to OpenAI to ensure your workflow never breaks.

Note: Legacy static port (10001) logic has been replaced with system-assigned ports (0). This eliminates "Address in use" errors and effectively removes the need for Linux-specific fuser commands, making the plugin fully Cross-Platform.

This plugin is part of the OpenCode Ecosystem.

Option 1: NPM (Instant Setup) (Recommended)

This method automatically configures OpenCode to load the plugin.

1. Install global:

   npm install -g opencode-pollinations-plugin

2. Run the Auto-Setup (Magic):

   npx opencode-pollinations-plugin

   This detects your OpenCode config and injects the plugin path automatically.

Option 2: Manual Configuration

1. Install globally as above.
2. Edit ~/.config/opencode/opencode.json:

   {
     "plugin": [
       "opencode-pollinations-plugin"
     ]
   }

   Note: If OpenCode fails to find it, use the absolute path to the global install.

🚀 Publication (The "Registry")

OpenCode uses NPM as its registry. To publish:

1. Publish to NPM:

   npm login
   npm publish

2. Join Ecosystem: Submit a Pull Request to OpenCode Ecosystem to list your plugin officially. Once accepted, users can find it via documentation or future registry commands.

🚀 Getting Started

1. The Basics (Free Mode)

Just type in the chat. You are in Manual Mode by default.

• Model: openai-fast (GPT-OSS 20b)
• Model: mistral (Mistral Small 3.1)
• ...

🔑 Configuration (API Key)

1. Run the setup command:

   /connect

2. Choose "pollinations" and enter your key if you have one (or leave blank for free tier).
3. IMPORTANT: You must restart OpenCode for the model list to update with your new tier (e.g. to see Paid models).

🤖 Models

🔑 Types de Clés Supportés

• Clés Standard (sk-...): Accès complet (Modèles + Dashboard Usage + Quota).
• Clés Limitées: Accès Génération uniquement. Le dashboard affichera une alerte de restriction (v5.4.11).
• Support Legacy: Les anciennes clés (sk_...) sont aussi acceptées.

🔗 Links

• Sign up Pollinations Beta (more and best free tiers access and paids models): pollinations.ai
• Pollinations Website: pollinations.ai
• Discord Community: Join us!
• OpenCode Ecosystem: opencode.ai

📜 License

MIT License. Created by fkom13 & The Pollinations Community.