Jina

> Release time: 2025-02-25 12:08:35



🙇 We'd like to thank all contributors for this new release! In particular,
Zac Li, Jina Dev Bot, 🙇


🆕 New Features

- [[fa7f11b9](https://github.com/jina-ai/jina/commit/fa7f11b92f50e387c3dcf443e4e96ca58cdff5ca)] __-__ support param in sm batch (#6229) (*Zac Li*)

🍹 Other Improvements

- [[ef3ad20f](https://github.com/jina-ai/jina/commit/ef3ad20f2bd350fdd32a1f947f5b48bb5245cf04)] __-__ __version__: the next version will be 3.33.1 (*Jina Dev Bot*)



Release & Version Identifier

Jina is shipped from two package management systems, PyPi and Docker Hub. This article clarifies the release cycle and version identifier behind each system.

<!-- START doctoc generated TOC please keep comment here to allow auto update -->
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->

- [PyPi package versioning](pypi-package-versioning)
- [Docker image versioning](docker-image-versioning)
- [Manual Release Entrypoint](manual-release-entrypoint)

<!-- END doctoc generated TOC please keep comment here to allow auto update -->


PyPi package versioning

We follow [PEP-440](https://www.python.org/dev/peps/pep-0440/), and a form of [semantic versioning](https://semver.org/) as explained above.

To install the latest final release:

bash
pip install -U jina


To install a particular final release:

bash
pip install jina==x.y.z


The term "final release" is relative to "developmental release" as described below.

Install Jina with Recommended Extensions

`pip install -U jina` only installs the core dependencies of Jina.

The recommended way of installing Jina is `pip install -U jina`

`"standard"` include extra dependencies that enables:
- Executor Hub + Docker support
- FastAPI + Websocket support (required when using `Flow(protocol='http')` or `Flow(protocol='websocket')`)
- the best compression via LZ4 algorithm
- the best async eventloop management via `uvloop`

Other extension tags such as `[devel]` can be found in [extra-requirements.txt](extra-requirements.txt).

Do I need "[standard]"?

Depends on how you use and distribute Jina.

If you are using/distributing Jina as a microservice, you often only need to install the core dependencies via `pip install jina`.

Developmental releases versioning

One every master-merging event, we create early releases directly from source control which do not conflict with later project releases. The version identifier for development release is `x.y.z.devN`, which adds a suffix `.dev`, followed by a non-negative integer value `N`, which is reset on every release.

To install the latest development release:

bash
pip install --pre jina


Version epochs


Release cycle and versioning
Jina is developed continuously by the community and core team. Updates are grouped and released at regular intervals to align with software development best practices.

Jina follows a form of numbered versioning. The version number of the product is a three-part value `x.y.z` where `x`, `y`, and `z` are the major, minor, and patch components respectively.

- Patch release (`x.y.z` -> `x.y.(z+1)`): Contain bug fixes, new features and breaking changes. Released weekly on a Wednesday morning CET.
- Minor release (`x.y.z -> x.(y+1).0`): Contain bug fixes, new features and breaking changes. Released monthly on the first Wednesday of the month CET. This release is more QA tested and considered more stable than a patch release.
- Major release (`x.y.z -> (x+1).0.0`): Are released based on the development cycle of the Jina company. There is no set scheduled for when these will occur.


The following example shows how Jina is released from 0.9 to 0.9.2 according to the schema we defined above.

|Event `e` | After `e`, `pip install jina` | After `e`, `pip install --pre jina` | After `e`, master `__init__.py` |
|--- | --- | --- | --- |

> Release time: 2024-12-20 12:13:19



🙇 We'd like to thank all contributors for this new release! In particular,
Joan Martinez, Joan Fontanals, Jina Dev Bot, 🙇


🆕 New Features

- [[da1d3117](https://github.com/jina-ai/jina/commit/da1d31170b932bdde2ad611fe4577e18b2c4ea01)] __-__ change return error code (#6220) (*Joan Fontanals*)

🏁 Unit Test and CICD

- [[dcacbe04](https://github.com/jina-ai/jina/commit/dcacbe04c8e83321eabc96261b8a72f06e3d3cca)] __-__ test uvicorn non standard install (#6223) (*Joan Fontanals*)
- [[0694771b](https://github.com/jina-ai/jina/commit/0694771b6d66c269043f06a2d12768326652ce88)] __-__ force release change (*Joan Martinez*)
- [[63d8d6a7](https://github.com/jina-ai/jina/commit/63d8d6a79d41bcb602a3df9e5a577de3e2d938de)] __-__ pdate force-release.yml (#6222) (*Joan Fontanals*)

🍹 Other Improvements

- [[626df92a](https://github.com/jina-ai/jina/commit/626df92a56da4fc96a04829ee07aefb46f3568f0)] __-__ update ver (*Joan Martinez*)
- [[173f421f](https://github.com/jina-ai/jina/commit/173f421f24aa58caa52e7cda010a26cb0fa40991)] __-__ change build (#6221) (*Joan Fontanals*)
- [[59f832a0](https://github.com/jina-ai/jina/commit/59f832a023c17a9678765458f712bdaa59922e9b)] __-__ __docs__: update TOC (*Jina Dev Bot*)
- [[24e16df3](https://github.com/jina-ai/jina/commit/24e16df3e06718f2fd2fb99a465f33e71e7a248a)] __-__ __version__: the next version will be 3.28.1 (*Jina Dev Bot*)

<a name=release-note-3-33-1></a>

> Release time: 2024-11-12 08:25:46



🙇 We'd like to thank all contributors for this new release! In particular,
Joan Fontanals, Jina Dev Bot, 🙇


🏁 Unit Test and CICD

- [[7f3ad55d](https://github.com/jina-ai/jina/commit/7f3ad55dc51a3398caf7e341150d15685b0065e0)] __-__ unblock grpcio version (#6198) (*Joan Fontanals*)

🍹 Other Improvements

- [[6a472c8c](https://github.com/jina-ai/jina/commit/6a472c8c49a9acbd53f49955994e349a15430fac)] __-__ update version (#6219) (*Joan Fontanals*)
- [[80996ca3](https://github.com/jina-ai/jina/commit/80996ca3a1395221fe1e8fbbb14ab45a9ea2b5af)] __-__ __docs__: update TOC (*Jina Dev Bot*)
- [[6edbbb14](https://github.com/jina-ai/jina/commit/6edbbb147eaacf7cc3248b7e10143dba6f8ece49)] __-__ __version__: the next version will be 3.27.21 (*Jina Dev Bot*)

<a name=release-note-3-33-0></a>

> Release time: 2024-11-05 09:18:22



🙇 We'd like to thank all contributors for this new release! In particular,
Joan Fontanals, Jina Dev Bot, 🙇


🐞 Bug fixes

- [[a51e5eec](https://github.com/jina-ai/jina/commit/a51e5eec4df0b80dee13fcd89044be1b42ed5c40)] __-__ fix req handling sagemaker (#6218) (*Joan Fontanals*)
- [[0337bc47](https://github.com/jina-ai/jina/commit/0337bc47b4beaf1c3ab5639bf55c88dd7c80ae7b)] __-__ test hubapp hubpods fix (#6217) (*Joan Fontanals*)

🍹 Other Improvements

- [[425e5ea6](https://github.com/jina-ai/jina/commit/425e5ea6a0f687f78d27b95e2f107c3319f499d2)] __-__ __docs__: update TOC (*Jina Dev Bot*)
- [[6ddc3406](https://github.com/jina-ai/jina/commit/6ddc34062c9a87075010c13136b1ba7f4902e666)] __-__ __version__: the next version will be 3.27.20 (*Jina Dev Bot*)

<a name=release-note-3-28-0></a>

> Release time: 2024-11-04 10:18:08



🙇 We'd like to thank all contributors for this new release! In particular,
Zac Li, Jina Dev Bot, 🙇


🆕 New Features

- [[92d03f08](https://github.com/jina-ai/jina/commit/92d03f08a3ae9ff02de207418cb4cde4d9fb93a2)] __-__ fix batch handling in sagemaker for clip (#6216) (*Zac Li*)

🍹 Other Improvements

- [[2f65ce10](https://github.com/jina-ai/jina/commit/2f65ce1074aeff7fd6b77c8b9cd2a0eca7e0dcbd)] __-__ __docs__: update TOC (*Jina Dev Bot*)
- [[8aee3a1d](https://github.com/jina-ai/jina/commit/8aee3a1d9dc7842425163ba36f82cb0e7f09c851)] __-__ __version__: the next version will be 3.27.19 (*Jina Dev Bot*)

<a name=release-note-3-27-20></a>

> Release time: 2024-10-25 16:57:06



🙇 We'd like to thank all contributors for this new release! In particular,
Han Xiao, Jina Dev Bot, 🙇


📗 Documentation

- [[d65d0c30](https://github.com/jina-ai/jina/commit/d65d0c30e5732d14477938a018f46d33463e3d51)] __-__ fix url (*Han Xiao*)
- [[99f4384a](https://github.com/jina-ai/jina/commit/99f4384a13595cd4c687e0ff062e75e43798f05b)] __-__ fix typo (*Han Xiao*)

🍹 Other Improvements

- [[ce97c322](https://github.com/jina-ai/jina/commit/ce97c322aaeca958e106458d0837927413a983b5)] __-__ replace docarray v1v2 to version number (*Han Xiao*)
- [[984da92d](https://github.com/jina-ai/jina/commit/984da92d126471a107e82fb0d77950696420be10)] __-__ update readme (*Han Xiao*)
- [[32f0cb30](https://github.com/jina-ai/jina/commit/32f0cb30dbd019cb60f24754befdfb30d2410e4a)] __-__ __docs__: update TOC (*Jina Dev Bot*)
- [[1e3dd5f2](https://github.com/jina-ai/jina/commit/1e3dd5f29b6c88548cd44a1be51d3226523cf81a)] __-__ __version__: the next version will be 3.27.18 (*Jina Dev Bot*)

<a name=release-note-3-27-19></a>