llama-stack-mirror/llama_stack/apis
Matthew Farrellee 914c7be288
feat: add batches API with OpenAI compatibility (with inference replay) (#3162)
Add complete batches API implementation with protocol, providers, and
tests:

Core Infrastructure:
- Add batches API protocol using OpenAI Batch types directly
- Add Api.batches enum value and protocol mapping in resolver
- Add OpenAI "batch" file purpose support
- Include proper error handling (ConflictError, ResourceNotFoundError)

Reference Provider:
- Add ReferenceBatchesImpl with full CRUD operations (create, retrieve,
cancel, list)
- Implement background batch processing with configurable concurrency
- Add SQLite KVStore backend for persistence
- Support /v1/chat/completions endpoint with request validation

Comprehensive Test Suite:
- Add unit tests for provider implementation with validation
- Add integration tests for end-to-end batch processing workflows
- Add error handling tests for validation, malformed inputs, and edge
cases

Configuration:
- Add max_concurrent_batches and max_concurrent_requests_per_batch
options
- Add provider documentation with sample configurations

Test with -

```
$ uv run llama stack build --image-type venv --providers inference=YOU_PICK,files=inline::localfs,batches=inline::reference --run &
$ LLAMA_STACK_CONFIG=http://localhost:8321 uv run pytest tests/unit/providers/batches tests/integration/batches --text-model YOU_PICK
```

addresses #3066

---------

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Co-authored-by: Ashwin Bharambe <ashwin.bharambe@gmail.com>
2025-08-15 15:34:15 -07:00
..
agents feat(responses): add MCP argument streaming and content part events (#3136) 2025-08-13 16:34:26 -07:00
batch_inference chore: remove nested imports (#2515) 2025-06-26 08:01:05 +05:30
batches feat: add batches API with OpenAI compatibility (with inference replay) (#3162) 2025-08-15 15:34:15 -07:00
benchmarks docs: Add detailed docstrings to API models and update OpenAPI spec (#2889) 2025-07-30 16:32:59 -07:00
common feat: add batches API with OpenAI compatibility (with inference replay) (#3162) 2025-08-15 15:34:15 -07:00
datasetio chore: remove nested imports (#2515) 2025-06-26 08:01:05 +05:30
datasets docs: Add detailed docstrings to API models and update OpenAPI spec (#2889) 2025-07-30 16:32:59 -07:00
eval chore: remove nested imports (#2515) 2025-06-26 08:01:05 +05:30
files feat: add batches API with OpenAI compatibility (with inference replay) (#3162) 2025-08-15 15:34:15 -07:00
inference docs: Add detailed docstrings to API models and update OpenAPI spec (#2889) 2025-07-30 16:32:59 -07:00
inspect docs: Add detailed docstrings to API models and update OpenAPI spec (#2889) 2025-07-30 16:32:59 -07:00
models docs: Add detailed docstrings to API models and update OpenAPI spec (#2889) 2025-07-30 16:32:59 -07:00
post_training fix: remove unused DPO parameters from schema and tests (#2988) 2025-07-31 09:11:08 -07:00
providers docs: Add detailed docstrings to API models and update OpenAPI spec (#2889) 2025-07-30 16:32:59 -07:00
safety chore: Change moderations api response to Provider returned categories (#3098) 2025-08-13 09:47:35 -07:00
scoring docs: Add detailed docstrings to API models and update OpenAPI spec (#2889) 2025-07-30 16:32:59 -07:00
scoring_functions docs: Add detailed docstrings to API models and update OpenAPI spec (#2889) 2025-07-30 16:32:59 -07:00
shields feat: create unregister shield API endpoint in Llama Stack (#2853) 2025-08-05 07:33:46 -07:00
synthetic_data_generation docs: Add detailed docstrings to API models and update OpenAPI spec (#2889) 2025-07-30 16:32:59 -07:00
telemetry docs: Add detailed docstrings to API models and update OpenAPI spec (#2889) 2025-07-30 16:32:59 -07:00
tools docs: Add detailed docstrings to API models and update OpenAPI spec (#2889) 2025-07-30 16:32:59 -07:00
vector_dbs docs: Add detailed docstrings to API models and update OpenAPI spec (#2889) 2025-07-30 16:32:59 -07:00
vector_io chore: Enabling Integration tests for Weaviate (#2882) 2025-07-31 20:29:50 -04:00
__init__.py API Updates (#73) 2024-09-17 19:51:35 -07:00
datatypes.py feat: add batches API with OpenAI compatibility (with inference replay) (#3162) 2025-08-15 15:34:15 -07:00
resource.py feat: drop python 3.10 support (#2469) 2025-06-19 12:07:14 +05:30
version.py llama-stack version alpha -> v1 2025-01-15 05:58:09 -08:00