🌟 HUGE CREDITS to the OG Creator @eyaltoledano 🌟

This project ("pollinations-taskmaster-ai") is a respectful fork, overhaul, and vivid remix of Eyal Toledano's legendary "Task Master". Every part of the architecture, original documentation, deep LLM workflow, and smart agent CLI leadership comes from the OG.

If you find this project useful, please ⭐ star the original repo as thanks to Eyal and show the LLM world some respect!

Original Task Master • X (Twitter): @eyaltoledano

Pollinations TaskMaster AI

By @LousyBook94 (maintenance/fork) • OG: @eyaltoledano • @RalphEcom

A task management system for AI-driven development using Pollinations.ai, designed to work seamlessly with Cursor AI.

Requirements

• Internet connection (for Pollinations.ai API access)

Quick Start

Option 1 | MCP (Recommended):

MCP (Model Control Protocol) provides the easiest way to get started with Pollinations TaskMaster AI directly in your editor.

1. Add the MCP config to your editor (Cursor recommended, but it works with other text editors):

{
	"mcpServers": {
		"taskmaster-ai": {
			"command": "npx",
			"args": ["-y", "--package=pollinations-taskmaster", "pollinations-taskmaster"],
			"env": {
				"ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_API_KEY_HERE",
				"PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY_HERE",
				"OPENAI_API_KEY": "YOUR_OPENAI_KEY_HERE",
				"GOOGLE_API_KEY": "YOUR_GOOGLE_KEY_HERE",
				"MISTRAL_API_KEY": "YOUR_MISTRAL_KEY_HERE",
				"OPENROUTER_API_KEY": "YOUR_OPENROUTER_KEY_HERE",
				"XAI_API_KEY": "YOUR_XAI_KEY_HERE",
				"AZURE_OPENAI_API_KEY": "YOUR_AZURE_KEY_HERE"
			}
		}
	}
}

2. Enable the MCP in your editor

3. Prompt the AI to initialize Pollinations TaskMaster AI:

Can you please initialize taskmaster-ai into my project?

4. Use common commands directly through your AI assistant:

Can you parse my PRD at scripts/prd.txt?
What's the next task I should work on?
Can you help me implement task 3?
Can you help me expand task 4?

Option 2: Using Command Line

Installation

# Install globally
npm install -g pollinations-taskmaster

# OR install locally within your project
npm install pollinations-taskmaster

Initialize a new project

# If installed globally
task-master init

# If installed locally
npx task-master init

This will prompt you for project details and set up a new project with the necessary files and structure.

Common Commands

# Initialize a new project
task-master init

# Parse a PRD and generate tasks
task-master parse-prd your-prd.txt

# List all tasks
task-master list

# Show the next task to work on
task-master next

# Generate task files
task-master generate

Documentation

For more detailed information, check out the documentation in the docs directory:

• Configuration Guide — Environment variables & model selection (Pollinations requires NO API key; Custom lets you use any OpenAI-compatible endpoint via CUSTOM_BASE/CUSTOM_API_KEY in .env or .taskmasterconfig)
• Tutorial — Step-by-step guide to getting started with Pollinations TaskMaster AI, including using Pollinations and Custom providers
• Command Reference — Complete list of all available commands and provider/model selection
• Task Structure — Understanding the task format and features
• Example Interactions — Common Cursor AI interaction examples

Provider Support & Configuration

🌱 Pollinations Provider (No API Key Needed)

• Use provider: "pollinations" in .taskmasterconfig for any role.
• Select from a wide range of free, open models (see task-master models --setup or supported-models.json).
• No API key or signup needed!

🛠️ Custom Provider (Bring Your Own OpenAI-Compatible Endpoint)

• Use provider: "custom" in .taskmasterconfig for any role.
• Set CUSTOM_BASE and CUSTOM_API_KEY in your .env file, or override with baseUrl and apiKey directly in .taskmasterconfig.
• Great for self-hosted, enterprise, or experimental endpoints.

Example .env:

CUSTOM_BASE=https://your-custom-endpoint.com/openai
CUSTOM_API_KEY=sk-your-custom-key

Example .taskmasterconfig:

"models": {
  "main": {
    "provider": "pollinations",
    "modelId": "openai" // or any available model
  },
  "research": {
    "provider": "pollinations",
    "modelId": "searchgpt"
  },
  "custom": {
    "provider": "custom",
    "modelId": "gpt-4o",
    "baseUrl": "https://your-custom-endpoint.com/openai", // optional override
    "apiKey": "sk-your-custom-key" // optional override
  }
}

Troubleshooting

If task-master init doesn't respond:

Try running it with Node directly:

node node_modules/pollinations-task-master/scripts/init.js

Or clone the repository and run:

git clone https://github.com/LousyBook94/pollinations-task-master.git
cd pollinations-task-master
node scripts/init.js

Contributors

Star History

Licensing

Pollinations TaskMaster AI is licensed under the MIT License with Commons Clause. AI Backed by Pollinations.ai 🌱 – 100% free, open LLM/GenAI APIs. No private keys, no Anthropic or OpenAI lock-in, just hassle-free LLM automation!

You can now use the Pollinations provider for free, or bring your own API with the Custom provider!

See the LICENSE file for the complete license text and licensing details for more information.