Getting started with RepoForge.io
This page walks you through signing up and publishing your first Python package with RepoForge.io.
What is RepoForge.io?
RepoForge.io is a secure, cloud hosted package repository that currently supports the following package types:
- Python
- Docker
- NPM
- Debian
- Conda
- Maven (Maven and Gradle)
RepoForge.io is a package management tool for any organization that uses the above package types, which allows you to store, manage and distribute your private packaged software securely and reliably.
Creating your account
Head to app.repoforge.io and choose Create one now for free! on the login page. The first step asks what you are publishing:

- Open-source packages is free forever, but all of your packages will be public.
- Private packages starts a 14-day free trial of the paid plan with all Advanced features. No card is needed.
Enter your email address and a password (at least 12 characters) to finish creating your account.

You can also sign in with Google or GitHub from the login page, or with your organization's identity provider if your account has SSO enabled.
The Get started page
After signing up you land on the Get started page of the dashboard. Choose the type of package you want to publish first (Python, Docker, NPM, Debian, Conda or Maven) and the page shows you your unique repository URL and the exact commands to run, with your own URL already filled in.

The page generates an access token for you on request, and listens for your first upload - as soon as your package arrives, the dashboard takes you straight to it. You can come back to this page at any time from the Get started link in the sidebar.
Pushing your first Python package to RepoForge.io
Once you sign up for RepoForge.io, you’ll be issued with a unique Python repository URL in the format https://api.repoforge.io/unique-hash/.
You can find your repository URL on the Get started page, or from the dashboard by clicking on Python > Push package. Make a note of your URL - you’ll need it to complete this tutorial.

You can use this unique URL as your endpoint for all of your Python packages.
Creating and publishing a package with uv
uv is the recommended tool for working with Python packages on RepoForge.io. It handles project creation, dependency management, building, and publishing in one fast tool.
1. Create a new project
uv init --package hello-repoforge
cd hello-repoforge2. Build your package
uv build3. Create an access token
In the dashboard, go to Access Tokens > Create new access token, give it a name and assign it the Python - Full access role. Copy the token value when it is shown - you will only see it once. See Authentication and permissions for more detail.
4. Publish to RepoForge.io
Set your credentials and publish. Use __token__ as the username and your access token as the password:
export UV_PUBLISH_USERNAME=__token__
export UV_PUBLISH_PASSWORD=YOUR_ACCESS_TOKEN
export UV_PUBLISH_URL=https://api.repoforge.io/unique-hash/
uv publishRefresh the Python page of the dashboard and your package will be listed there.

5. Install the package elsewhere
Add your RepoForge.io index to the consuming project's pyproject.toml:
[[tool.uv.index]]
name = "repoforge"
url = "https://api.repoforge.io/unique-hash/"
authenticate = "always"Then provide your credentials and add the package:
export UV_INDEX_REPOFORGE_USERNAME=__token__
export UV_INDEX_REPOFORGE_PASSWORD=YOUR_ACCESS_TOKEN
uv add hello-repoforgeOr with pip:
pip install hello-repoforge --extra-index-url https://__token__:YOUR_ACCESS_TOKEN@api.repoforge.io/unique-hash/For full details on publishing and installing with uv, see the uv guide.
Next steps
Congratulations, you have now learnt how to push Python packages to, and install them from, your RepoForge.io repository. You might want to have a look at the following topics next.