Install & Compatibility
Where this runs
tested against v0.4.90 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
605MB installed
● package 605MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
None
✓ This package is not meant for direct Python import or usage in user code.
The `litellm-proxy-extras` package primarily provides internal files like database migration scripts (e.g., Prisma schema.prisma) for the LiteLLM Proxy. Users interact with the `litellm` CLI or SDK, which then utilizes the contents of this package internally.
The `litellm-proxy-extras` package is not directly callable. Its primary function is to provide database migration files for the LiteLLM Proxy. To utilize its contributions, you typically install `litellm[proxy]` and then interact with the `litellm` CLI, for example, to run migrations. The quickstart demonstrates how to apply these migrations via the `litellm` CLI.
import os
# Ensure litellm[proxy] is installed
# pip install 'litellm[proxy]'
# To apply database migrations provided by litellm-proxy-extras
# This command starts the LiteLLM proxy and runs pending migrations.
# Ensure your database environment variables (e.g., POSTGRES_URL) are set.
# Example: os.environ['POSTGRES_URL'] = 'postgresql://user:password@host:port/database'
# In a terminal, run the following command:
# litellm --use_prisma_migrate
print("Refer to LiteLLM documentation for proxy setup and migration usage.")
# Example of starting the proxy with a model (requires API key in environment)
# os.environ["OPENAI_API_KEY"] = os.environ.get("OPENAI_API_KEY", "sk-your-openai-key")
# litellm --model openai/gpt-4o
Debug
Known issues
gotchaThe `litellm-proxy-extras` package is not intended for direct Python imports or programmatic use. It is an internal dependency for the `litellm` proxy, providing components like database migration files that are utilized by the `litellm` CLI or framework, not by user-written Python code directly referencing `litellm-proxy-extras`.fixDo not attempt to import or use `litellm-proxy-extras` in your Python code. Instead, manage and interact with the LiteLLM Proxy and its features (like migrations) through the `litellm` CLI or SDK.
affects: All versions
breakingWhen upgrading LiteLLM Proxy via `pip` (which includes `litellm-proxy-extras`), database migrations are *not* automatically applied. Users must manually regenerate the Prisma client and run migrations. This is a common footgun, as Docker deployments typically handle this automatically.fixAfter `pip install --upgrade litellm[proxy]`, you must explicitly run `litellm --use_prisma_migrate` to apply any new database schema changes. It is recommended to back up your database before running migrations.
affects: All versions
gotchaA supply chain attack affected `litellm` versions `1.82.7` and `1.82.8` on PyPI, which were live briefly on March 24, 2026. While `litellm-proxy-extras` itself was not explicitly named as containing the malicious payload, it is a core component of the `litellm` ecosystem, and caution is advised regarding all packages within that timeframe.fixAvoid using or immediately upgrade any `litellm` installations from affected versions. If you installed via `pip` on March 24, 2026, between 10:39 UTC and 16:00 UTC, verify your installation. Official Docker images were not impacted. Refer to the official LiteLLM security advisory for detailed steps and verified safe versions.
affects: LiteLLM versions 1.82.7 and 1.82.8 (March 24, 2026)
gotchaWhen dealing with LiteLLM Proxy database schema, the `schema.prisma` file located within the `litellm-proxy-extras` package is considered the definitive source of truth. Using `schema.prisma` files from other sources (e.g., older versions, Git repository) can lead to migration issues or data corruption.fixAlways refer to and use the `schema.prisma` file that ships with your installed `litellm-proxy-extras` package version when performing manual database operations or troubleshooting migrations.
affects: All versions
Upgrade
Version history
0.4.90latest on PyPI · released Aug 28, 2026
Audit
Dependencies
litellmrequiredThis package provides supplementary files (e.g., Prisma migrations) for the LiteLLM Proxy, which is part of the main `litellm` library.