google / google/adk-python

Make ADK Free Threaded Compatible

Abierto
#4,269 1 comentario 0 reacciones 1 asignado Reclamado por @wyf7107 Ver en GitHub
core needs review
Lenguaje dominante
Python
Estrellas
21.5k
Forks
4k
Merge medio
1 d 14 h
PR fusionados (30 d)
37

Descripción

## 🔴 Required Information
*Please ensure all items in this section are completed to allow for efficient
triaging. Requests without complete information may be rejected / deprioritized.
If an item is not applicable to you - please mark it as N/A*

### Is your feature request related to a specific problem?

It's not about a specific problem but about an improvement coming from the newer Python versions (3.14+).

### Describe the Solution You'd Like

As of Python version 3.14 the _Free GIL_ is considered stable but not enforced, we still have 3.14 with GIL. People will tend to use the Free GIL given the benefits of not having one thread running at once and it's important to support that behavior, as __maybe__ ADK itself does not handle anything than `asyncio` is still required to check if there's a potential area of lacking support for when the user uses threads.

An clear example is people serving ADK flows through FastAPI/Uvicorn that might be supporting Free GIL but as this library does not is fully compatible they won't be able to extract the benefits upstream.

### Impact on your work

_How does this feature impact your work and what are you trying to achieve?
If this is critical for you, tell us if there is a timeline by when you need
this feature._

It's not impacting my work right now but it could impact in the near future regarding developer experience as it'll "lock" developers choices.

### Willingness to contribute
Are you interested in implementing this feature yourself or submitting a PR?
(Yes/No)

Yes

---

## 🟡 Recommended Information

### Describe Alternatives You've Considered
_A clear and concise description of any alternative solutions or workarounds
you've considered and why they didn't work for you._

N/A

### Proposed API / Implementation
_If you have ideas on how this should look in code, please share a
pseudo-code example._

N/A

### Additional Context

- [Python support for free threading](https://docs.python.org/3/howto/free-threading-python.html)
- [Python Free-Threading Guide](https://py-free-threading.github.io)
- [Understanding the Global Interpreter Lock (GIL) and its Impact on Multithreaded Python Programs](https://github.com/facebookincubator/ft_utils/blob/main/docs/ft_worked_examples.md)

Guía de contribución

Abrir la guía de contribución

Evaluación

Este issue todavía no se ha evaluado.

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.