NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #3375 most downloaded on PyPI
Containers for machine learning
Last release 9 days ago
22 Sep 2026
Release timing varies
gaps range from 8 days to 2 months
Nearly every release is documented
notes for 59 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
5 years old
184 releases · first in 2021
One column per quarter.
Highlights in this release are deprecating python 3.7 and allowing a str in addition to Path and File for setup() weights argument. If you download we…
Highlights in this release are deprecating python 3.7 and allowing a str in addition to Path and File for setup() weights argument. If you download weights with pget, we highly recommend switching to str instead of Path so that cog doesn't also try to download your weights.
pget instructions in setup() docs for Python by @cuuupid in https://github.com/replicate/cog/pull/1576cog init templates by @zeke in https://github.com/replicate/cog/pull/1578Full Changelog: https://github.com/replicate/cog/compare/v0.9.4...v0.9.5
d255445 fix: ignore "train" part of schema errors during predict runs in production for backward compatibility
4f2d690 fix: add handling of early setup exceptions on "train" path in cog predict/build
tweak schema file console message by @technillogue in https://github.com/replicate/cog/pull/1371
Output class by @iamargentum in https://github.com/replicate/cog/pull/1444Full Changelog: https://github.com/replicate/cog/compare/v0.9.0-beta10...v0.9.0
> The wheel published to PyPI for cog 0.9.0 contains sources for the tag v0.9.0+async.1. This was unintentional, and the release will be yanked soon.
[!IMPORTANT]
The wheel published to PyPI for cog 0.9.0 contains sources for the tag v0.9.0+async.1. This was unintentional, and the release will be yanked soon. We've since published v0.9.1, which like v0.9.0 is set to 2a9211cff5695fcc9a13f4c156d5b9fa9f372812, and will have the correct wheel published to PyPI.
Output class by @iamargentum in https://github.com/replicate/cog/pull/1444Full Changelog: https://github.com/replicate/cog/compare/v0.9.0-beta10...v0.9.0
fix typo by @zeke in https://github.com/replicate/cog/pull/1471
Full Changelog: https://github.com/replicate/cog/compare/v0.9.0-beta12...v0.9.0-rc1
use a more realistic registry URL in cog push usage by @zeke in https://github.com/replicate/cog/pull/1404
Output class by @iamargentum in https://github.com/replicate/cog/pull/1444Full Changelog: https://github.com/replicate/cog/compare/v0.9.0-beta11...v0.9.0-beta12
async runner by @technillogue in https://github.com/replicate/cog/pull/1352
Full Changelog: https://github.com/replicate/cog/compare/v0.9.0-beta10...v0.9.0-beta11
f5a7030 Get faster initial output from latency-sensitive models
support async predict functions by @technillogue in https://github.com/replicate/cog/pull/1350
Full Changelog: https://github.com/replicate/cog/compare/v0.9.0-beta8...v0.9.0-beta9
fix updating pip in multistage cuda images by @technillogue in https://github.com/replicate/cog/pull/1342
.glb, .mtl and .obj files by @mattt in https://github.com/replicate/cog/pull/1353Full Changelog: https://github.com/replicate/cog/compare/v0.9.0-beta7...v0.9.0-beta8
added installing buildx to doc by @dsingal0 in https://github.com/replicate/cog/pull/1321
Full Changelog: https://github.com/replicate/cog/compare/v0.9.0-beta6...v0.9.0-beta7
Fix usage description for --dockerfile option by @mattt in https://github.com/replicate/cog/pull/1314
--dockerfile option by @mattt in https://github.com/replicate/cog/pull/1314--dockerfile flag by @mattt in https://github.com/replicate/cog/pull/1315Full Changelog: https://github.com/replicate/cog/compare/v0.9.0-beta5...v0.9.0-beta6
> This prerelease introduces a potentially breaking change for Cog models without a predict or train function. Before, such a model could be built suc…
[!WARNING] This prerelease introduces a potentially breaking change for Cog models without a
predictortrainfunction. Before, such a model could be built successfully. Now, this produces a build error during OpenAPI schema validation. Please open an issue if you rely on the old behavior.
Union and List input types by @mattt in https://github.com/replicate/cog/pull/1311cog build and cog push to specify path to custom Dockerfile by @technillogue in https://github.com/replicate/cog/pull/1229Full Changelog: https://github.com/replicate/cog/compare/v0.9.0-beta4...v0.9.0-beta5
fix an error with multistage symlinks by @technillogue in https://github.com/replicate/cog/pull/1307
Full Changelog: https://github.com/replicate/cog/compare/v0.9.0-beta3...v0.9.0-beta4
Bump github.com/docker/cli from 24.0.5+incompatible to 24.0.6+incompatible by @dependabot in https://github.com/replicate/cog/pull/1297
sys.argv while importing predictor module by @nickstenning in https://github.com/replicate/cog/pull/1304Full Changelog: https://github.com/replicate/cog/compare/v0.9.0-beta2...v0.9.0-beta3
add --force flag to ln by @technillogue in https://github.com/replicate/cog/pull/1295
Full Changelog: https://github.com/replicate/cog/compare/v0.9.0-beta1...v0.9.0-beta2
Bump github.com/golangci/golangci-lint from 1.53.3 to 1.54.1 by @dependabot in https://github.com/replicate/cog/pull/1260
Full Changelog: https://github.com/replicate/cog/compare/v0.8.6...v0.9.0-beta1
Bump golang.org/x/tools from 0.11.1 to 0.12.0 by @dependabot in https://github.com/replicate/cog/pull/1249
This version includes a feature from @technillogue that lets you specify a custom OpenAPI spec file with:
cog build --openapi-schema=path/to/schema.json
This pairs nicely with a new Python command that can generate an OpenAPI specification using an AST, which can be much faster than generating during a build. The intent is that a user can generate the OpenAPI spec (perhaps with the AST tool, perhaps modifying by hand), save it to a file, and then pass it to cog build to tighten up the development loop.
Full Changelog: https://github.com/replicate/cog/compare/v0.8.5...v0.8.6
Bump golang.org/x/tools from 0.11.0 to 0.11.1 by @dependabot in https://github.com/replicate/cog/pull/1240
Full Changelog: https://github.com/replicate/cog/compare/v0.8.4...v0.8.5
64bf012 Bump actions/setup-python from 3 to 4
Bump github.com/docker/docker from 24.0.4+incompatible to 24.0.5+incompatible by @dependabot in https://github.com/replicate/cog/pull/1227
Full Changelog: https://github.com/replicate/cog/compare/v0.8.2...v0.8.3
cb5b9bc Add --use-cuda-base-image flag
--use-cuda-base-image flag (#1214)tini in separate stage (#1161)" (#1231)file.seek(0) (#990)Add back support for Python 3.7 by @nickstenning in https://github.com/replicate/cog/pull/1201
Full Changelog: https://github.com/replicate/cog/compare/v0.8.0...v0.8.1
Update goreleaser configuration to remove deprecated replacements field by @mattt in https://github.com/replicate/cog/pull/1176
generate_compatibility_matrices and regenerate compatibility matrices by @mattt in https://github.com/replicate/cog/pull/1057pyproject.toml to root directory by @mattt in https://github.com/replicate/cog/pull/1058pyproject.toml using pip-tools by @mattt in https://github.com/replicate/cog/pull/1059python_packages, system_packages, pre_install, and run in cog.yaml by @mattt in https://github.com/replicate/cog/pull/1073--link option by @mattt in https://github.com/replicate/cog/pull/1104cog init template to use Python 3.11 by @mattt in https://github.com/replicate/cog/pull/1112DOCKER_DEFAULT_PLATFORM=linux/amd64 when running cog predict on M1/M2 Macs by @mattt in https://github.com/replicate/cog/pull/1114.dockerignore file to cog init template by @mattt in https://github.com/replicate/cog/pull/1136cog predict by @mattt in https://github.com/replicate/cog/pull/1154cog- to default image name by @mattt in https://github.com/replicate/cog/pull/1148MAJOR.MINOR to match MAJOR.MINOR.PATCH with non-zero patch by @mattt in https://github.com/replicate/cog/pull/1175goreleaser configuration to remove deprecated replacements field by @mattt in https://github.com/replicate/cog/pull/1176tini in separate stage by @mattt in https://github.com/replicate/cog/pull/1161ValidateAndComplete by @mattt in https://github.com/replicate/cog/pull/1174Full Changelog: https://github.com/replicate/cog/compare/v0.7.2...v0.8.0
2e331c7 Download tini in separate stage
tini in separate stage (#1161)a7a1e4c Inline replacements rules into name_template
0ced8d7 Add .dockerignore file to cog init template
.dockerignore file to cog init template (#1136)cog predict (#1154)2c04f26 Automatically set DOCKER_DEFAULT_PLATFORM=linux/amd64 when running cog predict on M1/M2 Macs
DOCKER_DEFAULT_PLATFORM=linux/amd64 when running cog predict on M1/M2 Macs (#1114)390c3d0 Bump github.com/golangci/golangci-lint from 1.50.1 to 1.53.3
--link option (#1104)cog init template to use Python 3.11 (#1112)fe784d1 Bump attrs from 22.2.0 to 23.1.0
2ab4e71 Allow null for python_packages, system_packages, pre_install, and run
ef4bac6 Fix warning 'Input 'packages_dir' has been deprecated with message: The inputs have been normalized to use kebab-case. Use packages-dir instea…
packages-dir instead.'pyproject.toml using pip-tools (#1059)pyproject.toml to root directory (#1058)8f95ed7 Fix generate_compatibility_matrices and regenerate compatibility matrices
generate_compatibility_matrices and regenerate compatibility matrices (#1057)da27e02 Catch missing GPU when running cog build
642f550 Fix regression in cog predict
cog predict (#1029)4fc694a Document python_requirements field in cog.yaml
cog for development by @mattt in https://github.com/replicate/cog/pull/851--redis-url argument for connecting to redis from URL" by @bfirsh in https://github.com/replicate/cog/pull/865--redis-url argument for connecting to redis from URL"" by @bfirsh in https://github.com/replicate/cog/pull/866COG_VERSION is set in cog Makefile target by @mattt in https://github.com/replicate/cog/pull/894mime package by @mattt in https://github.com/replicate/cog/pull/980pypa/gh-action-pypi-publish to release/v1 in CI workflow by @mattt in https://github.com/replicate/cog/pull/1012--secret flag to cog build and cog push commands by @mattt in https://github.com/replicate/cog/pull/1013test job to test-go in CI workflow by @mattt in https://github.com/replicate/cog/pull/1018python_requirements field in cog.yaml by @mattt in https://github.com/replicate/cog/pull/1016Full Changelog: https://github.com/replicate/cog/compare/v0.6.1...v0.7.0
f15107c Add --secret flag to cog build and cog push commands
--secret flag to cog build and cog push commands (#1013)55431e3 Add support for build secrets
31a5edf Add train hello world project
cog trainc896373 Add ConcatenateIterator type
c15513e Make message_id an instance var of RedisConsumer
6eddfaf Only mark container as ready after successful setup
## Changelog * 8a72ba8 Run setup on a thread
f6d5afe Add descriptions to JSON Schema fields
fa82cfa director: add prediction.error
be661dc director: set span attributes from env
4cf3bf0 director: change default trace exporter to http
2afcf3f Revert "Does not fail if there are not any nvidia packages to remove (#582)"
95e2f2b Stop leaking Redis secrets on connection
2359d64 Ignore XREADGROUP error on missing queue
ed9b7da Defer downloading of URLs provided to Path inputs
a20adaf Add a basic PUT endpoint for prediction creation
269fbc6 Loosen response type annotations
965c90a Construct RedisConsumers before passing in to RedisConsumerRotator
a872309 Abort prediction on a failed healthcheck event
--redis-url argument for connecting to redis from URL Signed-off-by: Brandon Berhent bbedward@gmail.com--redis-url argument for connecting to redis from URL"--redis-url argument for connecting to redis from URL""Cog v0.6.1! This is a bugfix release. We made a silly mistake in our recent changes to bring the Cog HTTP API into closer alignment with Replicate's o
Cog v0.6.1! This is a bugfix release. We made a silly mistake in our recent changes to bring the Cog HTTP API into closer alignment with Replicate's own API. Oops! 😳
Welcome to Cog v0.6.0! Three changes this time:
Welcome to Cog v0.6.0! Three changes this time:
cog.__version__. https://github.com/replicate/cog/pull/843Worker class introduced in v0.5.0. This is the first step towards an asynchronous API that matches Replicate's API. https://github.com/replicate/cog/pull/824brew install cogbf08e07 Add an explicit handler to die on SIGTERM
Welcome to Cog v0.5.0! It's been a while since we've made a release, and there's a lot of stuff going on here.
Welcome to Cog v0.5.0! It's been a while since we've made a release, and there's a lot of stuff going on here.
If you're using the Redis queue worker, this is a breaking release. If you're not using that worker, this release is backwards compatible with previous versions of Cog.
Almost all of this release is about the Redis queue worker. We've been rebuilding the infrastructure for Replicate – improving the reliability and performance – and in the process have been moving some of the features of our serving platform directly into Cog. If you're using Cog to run your own models in production, then these changes are for you.
We're not done yet though! We're currently working on the HTTP interface, bringing it up to scratch. And we've got some big plans to use that updated interface to make serving machine learning models even easier and safer.
First up, a couple of quality of life fixes:
ctrl+c is pressed during cog predict #751buildx #798And now, the Redis queue worker:
Your coding agent can read these notes before it upgrades. Set up the MCP server →