[](https://github.com/parasail-ai/openai-batch/actions/workflows/tests.yml)
[](https://pypi.org/project/openai-batch/)
# openai-batch
Batch inferencing is an easy and inexpensive way to process thousands or millions of LLM inferences.
The process is:
1. Write inferencing requests to an input file
2. start a batch job
3. wait for it to finish
4. download the output
This library aims to make these steps easier. The OpenAI protocol is relatively easy to use, but it has a lot of boilerplate steps. This library automates those.
#### Supported Providers
* [OpenAI](https://openai.com/) - ChatGPT, GPT4o, etc.
* [Parasail](https://parasail.io/) - Most transformer models on HuggingFace, such as LLama, Qwen, LLava, etc.
## Command-Line Utilities
Use `openai_batch.run` to run a batch from an input file on disk:
```bash
python -m openai_batch.run input.jsonl
```
This will start the batch, wait for it to complete, then download the results.
Useful switches:
* `-c` Only create the batch, do not wait for it.
* `--resume` Attach to an existing batch job. Wait for it to finish then download results.
* `--dry-run` Confirm your configuration without making an actual request.
* Full list: `python -m openai_batch.run --help`
### OpenAI Example
```bash
export OPENAI_API_KEY="<Your OpenAI API Key>"
# Create an example batch input file
python -m openai_batch.example_prompts | \
python -m openai_batch.create_input --model 'gpt-4o-mini' > input.jsonl
# Run this batch (resumable with `--resume <BATCH_ID>`)
python -m openai_batch.run input.jsonl
```
### Parasail Example
```bash
export PARASAIL_API_KEY="<Your Parasail API Key>"
# Create an example batch input file
python -m openai_batch.example_prompts | \
python -m openai_batch.create_input --model 'meta-llama/Meta-Llama-3-8B-Instruct' > input.jsonl
# Run this batch (resumable with `--resume <BATCH_ID>`)
python -m openai_batch.run -p parasail input.jsonl
```
## Resources
* [OpenAI Batch Cookbook](https://cookbook.openai.com/examples/batch_processing)
* [OpenAI Batch API reference](https://platform.openai.com/docs/api-reference/batch)
* [OpenAI Files API reference](https://platform.openai.com/docs/api-reference/files)
* [Anthropic's Message Batches](https://www.anthropic.com/news/message-batches-api) - Uses a different API
Raw data
{
"_id": null,
"home_page": null,
"name": "openai-batch",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "openai, batch, chatgpt, gpt, llm, language model",
"author": "Parasail",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/29/24/ec7773f02c5d1fb875813bedfb04242f808f1fdce63aed3b860d33e5c28d/openai_batch-0.1.3.tar.gz",
"platform": null,
"description": "[](https://github.com/parasail-ai/openai-batch/actions/workflows/tests.yml)\n[](https://pypi.org/project/openai-batch/)\n\n# openai-batch\n\nBatch inferencing is an easy and inexpensive way to process thousands or millions of LLM inferences.\n\nThe process is:\n1. Write inferencing requests to an input file\n2. start a batch job\n3. wait for it to finish\n4. download the output\n\nThis library aims to make these steps easier. The OpenAI protocol is relatively easy to use, but it has a lot of boilerplate steps. This library automates those.\n\n#### Supported Providers\n\n* [OpenAI](https://openai.com/) - ChatGPT, GPT4o, etc.\n* [Parasail](https://parasail.io/) - Most transformer models on HuggingFace, such as LLama, Qwen, LLava, etc.\n\n\n## Command-Line Utilities\n\nUse `openai_batch.run` to run a batch from an input file on disk:\n```bash\npython -m openai_batch.run input.jsonl\n```\n\nThis will start the batch, wait for it to complete, then download the results.\n\nUseful switches:\n* `-c` Only create the batch, do not wait for it.\n* `--resume` Attach to an existing batch job. Wait for it to finish then download results.\n* `--dry-run` Confirm your configuration without making an actual request.\n* Full list: `python -m openai_batch.run --help`\n\n### OpenAI Example\n```bash\nexport OPENAI_API_KEY=\"<Your OpenAI API Key>\"\n\n# Create an example batch input file\npython -m openai_batch.example_prompts | \\\n python -m openai_batch.create_input --model 'gpt-4o-mini' > input.jsonl\n\n# Run this batch (resumable with `--resume <BATCH_ID>`)\npython -m openai_batch.run input.jsonl\n```\n\n### Parasail Example\n\n```bash\nexport PARASAIL_API_KEY=\"<Your Parasail API Key>\"\n\n# Create an example batch input file\npython -m openai_batch.example_prompts | \\\n python -m openai_batch.create_input --model 'meta-llama/Meta-Llama-3-8B-Instruct' > input.jsonl\n\n# Run this batch (resumable with `--resume <BATCH_ID>`)\npython -m openai_batch.run -p parasail input.jsonl\n```\n\n## Resources\n\n* [OpenAI Batch Cookbook](https://cookbook.openai.com/examples/batch_processing)\n* [OpenAI Batch API reference](https://platform.openai.com/docs/api-reference/batch)\n* [OpenAI Files API reference](https://platform.openai.com/docs/api-reference/files)\n* [Anthropic's Message Batches](https://www.anthropic.com/news/message-batches-api) - Uses a different API\n",
"bugtrack_url": null,
"license": null,
"summary": "Make OpenAI batch easy to use.",
"version": "0.1.3",
"project_urls": {
"homepage": "https://github.com/parasail-ai/openai-batch",
"repository": "https://github.com/parasail-ai/openai-batch"
},
"split_keywords": [
"openai",
" batch",
" chatgpt",
" gpt",
" llm",
" language model"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f13e3b5957d39f4abbb5b36c49e681c5ce6b62b1083c979036c442c071460ce8",
"md5": "f12a79cb4da975c8a402e2913d3e1456",
"sha256": "f5fd25d23797e664bcb4180a03f0ecf0780d4ac50fb0426d8eeecbaaaaf7f953"
},
"downloads": -1,
"filename": "openai_batch-0.1.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f12a79cb4da975c8a402e2913d3e1456",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 14153,
"upload_time": "2025-01-08T23:34:34",
"upload_time_iso_8601": "2025-01-08T23:34:34.397338Z",
"url": "https://files.pythonhosted.org/packages/f1/3e/3b5957d39f4abbb5b36c49e681c5ce6b62b1083c979036c442c071460ce8/openai_batch-0.1.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "2924ec7773f02c5d1fb875813bedfb04242f808f1fdce63aed3b860d33e5c28d",
"md5": "323b07fd589f5b1858d6aca1e6b25025",
"sha256": "626ab7608edb4243c81e7655f8dd64f1038cba7eff53c9df3963f4bec60eb0d1"
},
"downloads": -1,
"filename": "openai_batch-0.1.3.tar.gz",
"has_sig": false,
"md5_digest": "323b07fd589f5b1858d6aca1e6b25025",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 17831,
"upload_time": "2025-01-08T23:34:36",
"upload_time_iso_8601": "2025-01-08T23:34:36.661695Z",
"url": "https://files.pythonhosted.org/packages/29/24/ec7773f02c5d1fb875813bedfb04242f808f1fdce63aed3b860d33e5c28d/openai_batch-0.1.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-08 23:34:36",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "parasail-ai",
"github_project": "openai-batch",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "openai-batch"
}
JSON
