Appearance
Getting started with RepoForge.io
This page demonstrates how to publish 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
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.
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 retrieve your repository URL from the RepoForge.io dashboard, by clicking on Python Packages > Show me how to publish packages. 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. It is fully compatible with public repositories such as https://pypi.org/simple/.
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
bash
uv init --package hello-repoforge
cd hello-repoforge2. Configure the RepoForge.io index
Add the following to your pyproject.toml, replacing the URL with your own:
toml
[[tool.uv.index]]
name = "repoforge"
url = "https://api.repoforge.io/unique-hash/"
publish-url = "https://api.repoforge.io/unique-hash/"
authenticate = "always"3. Build your package
bash
uv build4. Publish to RepoForge.io
bash
uv publish --index repoforgeYou’ll be prompted for credentials. Use __token__ as the username and your RepoForge.io access token as the password. To skip the prompt, pass the token directly:
bash
uv publish --index repoforge --token YOUR_ACCESS_TOKEN5. Install the package elsewhere
bash
uv add hello-repoforgeOr with pip-style install:
bash
uv pip install hello-repoforge --index-url https://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.