Pollux

Pollux sends prompts and multimodal sources to several LLM providers through one small Python interface. It handles uploads, shared context, retries, provider differences, and normalized results.

Install

pip install --upgrade pollux-ai

Set the key for the provider you want to use:

export GEMINI_API_KEY="your-key-here"     # or
export OPENAI_API_KEY="your-key-here"     # or
export ANTHROPIC_API_KEY="your-key-here"  # or
export OPENROUTER_API_KEY="your-key-here"

The local provider does not need a key. Point it at an OpenAI-compatible server with base_url or POLLUX_LOCAL_BASE_URL.

Ask About a File

import asyncio

from pollux import Config, Source, run

result = asyncio.run(
    run(
        "What are the key findings?",
        source=Source.from_file("paper.pdf"),
        config=Config(provider="gemini", model="gemini-2.5-flash-lite"),
    )
)

print(result.text)

run() returns an Output. Alongside text, it can contain structured data, tool calls, reasoning, token usage, completion details, and continuation state.

Changing providers is a configuration change:

Config(provider="openai", model="gpt-5-nano")
Config(provider="anthropic", model="claude-haiku-4-5")
Config(provider="openrouter", model="google/gemma-3-27b-it:free")
Config(provider="local", model="gemma3:4b", base_url="http://localhost:11434/v1")

Ask Several Questions About Shared Context

import asyncio

from pollux import Config, Source, run_many

results = asyncio.run(
    run_many(
        [
            "Summarize the methodology.",
            "List the key findings.",
            "Identify the main limitation.",
        ],
        sources=[Source.from_file("paper.pdf")],
        config=Config(provider="gemini", model="gemini-2.5-flash-lite"),
    )
)

for answer in results.answers:
    print(answer)

Every prompt sees the same source set. Pollux reuses uploaded content and runs the prompts concurrently. To process separate files independently, write the outer loop in your application and call run() or run_many() for each file.

Choose the Smallest Entry Point

Need	Use
One answer now	`run()`
Several prompts over shared sources	`run_many()`
Conversation history or tool calls	`interact()` or `Session`
Incremental output	`stream()`
Provider-side asynchronous work	`defer()`

The advanced entry points use the same Environment, Input, Output, and OutputCollection types as the simple path.

Documentation

Development

uv sync
just check

See Contributing for the repository layout and focused development commands.

License

MIT

Download files

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

Source Distribution

pollux_ai-2.0.0.tar.gz (809.2 kB view details)

Uploaded Aug 30, 2026 Source

Built Distribution

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

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

pollux_ai-2.0.0-py3-none-any.whl (126.8 kB view details)

Uploaded Aug 30, 2026 Python 3

File details

Details for the file pollux_ai-2.0.0.tar.gz.

File metadata

Download URL: pollux_ai-2.0.0.tar.gz
Upload date: Aug 30, 2026
Size: 809.2 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for pollux_ai-2.0.0.tar.gz
Algorithm	Hash digest
SHA256	`f37d16fa9d8d3d9e9c8cfde2fa472b4e28ffd028d0c78939609303cffd0462b9`
MD5	`6f5b945cf9b209255b15bbf09491ff1b`
BLAKE2b-256	`97ea0fd85a2fe12b0d81bc1d570f566e73baa50f9a4ded7d03b3076906ffab10`

See more details on using hashes here.

Provenance

The following attestation bundles were made for pollux_ai-2.0.0.tar.gz:

Publisher: release.yml on seanbrar/pollux

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

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: pollux_ai-2.0.0.tar.gz
- Subject digest: f37d16fa9d8d3d9e9c8cfde2fa472b4e28ffd028d0c78939609303cffd0462b9
- Sigstore transparency entry: 2655189663
- Sigstore integration time: Aug 30, 2026
Source repository:
- Permalink: seanbrar/pollux@1ac52f44e01185dca456b5a54e1d0ff9aaf59419
- Branch / Tag: refs/tags/v2.0.0
- Owner: https://github.com/seanbrar
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@1ac52f44e01185dca456b5a54e1d0ff9aaf59419
- Trigger Event: push