PyPI

Overview

Your private Python packages and public dependencies from PyPI, all managed through one registry.

Supported Clients

JFrog Fly supports Python packages with:

Twine (twine upload) - The official tool for publishing packages to PyPI
pip (pip install) - The standard package installer for Python
Pipenv (pipenv install) - Package installer with virtual environment management
Poetry (poetry publish, poetry install) - Dependency management and packaging tool

Upload / Publish Package

With Fly App

Activate your Python tools in the Fly App. Fly detects your installed tools and configures them automatically. Once activated, publish your package:

Twine

twine upload dist/*

Poetry

poetry publish

Manual Configuration

1. Generate an access token in Fly Token Management

Twine

2. Create ~/.pypirc:

[distutils]
index-servers = pypi

[pypi]
repository = https://<your-fly-subdomain>.jfrog.io/artifactory/api/pypi/pypi
username = <your-fly-username>
password = <your-fly-token>

Tip

Using pypi as the section name makes it the default repository for Twine, so you don’t need to specify -r when uploading.

3. Upload:

twine upload dist/*

Poetry

2. Configure the repository:

poetry config repositories.pypi https://<your-fly-subdomain>.jfrog.io/artifactory/api/pypi/pypi
poetry config http-basic.pypi <your-fly-username> <your-fly-token>

3. Publish:

poetry publish -r pypi

Important

You cannot publish a package version that already exists. Increment the version before publishing again.

Download / Install Package

With Fly App

Activate your Python tools in the Fly App. Fly detects your installed tools and configures them automatically. Once activated, install packages as usual:

pip

pip install <package-name>

Pipenv

pipenv install <package-name>

Poetry

poetry add <package-name>

Manual Configuration

1. Generate an access token in Fly Token Management

pip / Pipenv

2. Create ~/.config/pip/pip.conf (Linux/macOS) or %APPDATA%\pip\pip.ini (Windows):

[global]
index-url = https://<your-fly-username>:<your-fly-token>@<your-fly-subdomain>.jfrog.io/artifactory/api/pypi/pypi/simple

3. Install:

pip install <package-name>

Pipenv uses the same pip configuration, so pipenv install <package-name> works automatically.

Poetry

2. Add Fly as a source in your pyproject.toml:

[[tool.poetry.source]]
name = "fly"
url = "https://<your-fly-subdomain>.jfrog.io/artifactory/api/pypi/pypi/simple"
priority = "primary"

3. Configure authentication:

poetry config http-basic.fly <your-fly-username> <your-fly-token>

4. Install:

poetry add <package-name>

From Public Registry

When you install a package that isn’t in your Fly Registry, JFrog Fly automatically fetches it from PyPI and caches it for future use. Just install as usual – for example, pip install requests, pipenv install requests, or poetry add requests.

Publish/Install Packages with CI

To publish and install Python packages with CI, update your GitHub Actions workflow to include the Fly action.

Simply ask your coding agent: “Configure my workflows with Fly” and Fly MCP will configure your GitHub Actions workflow yml file, as follows:

1. Add permissions (top level, after on:):

permissions:
  contents: read
  id-token: write

2. Add Fly Action (after actions/setup-python, before pip/twine commands):

- uses: jfrog/fly-action@v1              # Setup Fly package managers

GitHub Action Example

name: Build and Publish Python Package

on:
  push:
    branches: [main]

permissions:
  contents: read
  id-token: write

jobs:
  build:
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v4

      - uses: actions/setup-python@v5
        with:
          python-version: '3.11'

      - uses: jfrog/fly-action@v1              # Setup Fly package managers

      - run: pip install build twine           # Dependencies from Fly registry

      - run: python -m build

      - run: twine upload dist/*               # Publish to Fly registry

Back to Package Managers →