Skip to main content

CLI coding agent powered by Pollinations.ai

Project description

Bloom

CLI coding agent powered by Pollinations.ai. Uses GLM-5 by default, with access to 25+ models through the Pollinations API.

Install

# With uv (recommended)
uv tool install bloom-cli

# With pip
pip install bloom-cli

Setup

  1. Get an API key from enter.pollinations.ai
  2. Run bloom --setup or set the environment variable:
export POLLINATIONS_API_KEY=sk_your_key_here

Usage

# Interactive mode
bloom

# With an initial prompt
bloom "fix the authentication bug in login.py"

# Programmatic mode (auto-approve, output, exit)
bloom -p "add type hints to utils.py"

# Use a specific model
bloom --model deepseek "refactor this function"

# Continue last session
bloom --continue

In interactive mode, press Shift+Tab to toggle auto-approve for all tool executions.

Available Models

Models are fetched dynamically from the Pollinations API. Only models with tool-calling support are available for agentic use. Common choices:

Model Alias Reasoning Notes
GLM-5 glm-5 Yes Default. 744B MoE, strong coding
DeepSeek V3.2 deepseek Yes Fast, good at code
Qwen3 Coder 30B qwen-coder No Lightweight coding model
Mistral Small 3.2 mistral No General purpose, via Pollinations

Switch models with /config in the TUI or bloom --model <name>.

Configuration

Config lives at ~/.bloom/config.toml:

active_model = "glm-5"

[[providers]]
name = "pollinations"
api_base = "https://gen.pollinations.ai/v1"
api_key_env_var = "POLLINATIONS_API_KEY"

[[models]]
name = "glm"
provider = "pollinations"
alias = "glm-5"

Tools

Bloom has a full set of agentic tools:

  • bash - Execute shell commands
  • read_file / write_file - Read and write files
  • search_replace - Edit files with search and replace
  • grep - Search file contents
  • ls - List directory contents
  • task - Spawn sub-agents for complex tasks
  • MCP server support for extensibility

Project Files

Bloom recognizes per-project configuration:

  • BLOOM.md or .bloom.md - Project-specific instructions (like CLAUDE.md)
  • .bloom/config.toml - Project-specific config overrides
  • .bloom/tools/ - Custom tool definitions
  • .bloom/agents/ - Custom agent profiles

License

Apache 2.0. See LICENSE.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bloom_cli-0.1.0.tar.gz (390.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

bloom_cli-0.1.0-py3-none-any.whl (226.6 kB view details)

Uploaded Python 3

File details

Details for the file bloom_cli-0.1.0.tar.gz.

File metadata

  • Download URL: bloom_cli-0.1.0.tar.gz
  • Upload date:
  • Size: 390.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for bloom_cli-0.1.0.tar.gz
Algorithm Hash digest
SHA256 f87589ad1d2bf88f12cca7069a58e5174e7a2ea0315652862afb594ac7448fbc
MD5 51cc7c21525d8e0575957b37723529d8
BLAKE2b-256 c04175e01516ffa7164846eeb19660ad5205ce325ef0c6869c204d1e0b866536

See more details on using hashes here.

Provenance

The following attestation bundles were made for bloom_cli-0.1.0.tar.gz:

Publisher: release.yml on Ilm-Alan/bloom

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file bloom_cli-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: bloom_cli-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 226.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for bloom_cli-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 2a8a4026959e16da4f27af127d94af68da02c05c05078eff8f532cbb1c98033f
MD5 ff7020900be433dd0c0c43065c0f98a0
BLAKE2b-256 1995b3493cf337446d38b4249ec32da532eb4d59a63fd27b7075a05c38c8db13

See more details on using hashes here.

Provenance

The following attestation bundles were made for bloom_cli-0.1.0-py3-none-any.whl:

Publisher: release.yml on Ilm-Alan/bloom

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page