{"id":22762332,"url":"https://github.com/prrao87/uv-demo","last_synced_at":"2026-05-11T06:01:36.203Z","repository":{"id":266378231,"uuid":"898187086","full_name":"prrao87/uv-demo","owner":"prrao87","description":"Demo of uv for a streamlined Python package management experience","archived":false,"fork":false,"pushed_at":"2024-12-27T00:46:35.000Z","size":124,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-29T08:02:42.128Z","etag":null,"topics":["database","graph","graphdb","kuzu","rag","uv"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/prrao87.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-04T00:12:09.000Z","updated_at":"2024-12-27T00:46:38.000Z","dependencies_parsed_at":"2024-12-04T01:32:56.486Z","dependency_job_id":null,"html_url":"https://github.com/prrao87/uv-demo","commit_stats":null,"previous_names":["prrao87/uv-demo"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prrao87%2Fuv-demo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prrao87%2Fuv-demo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prrao87%2Fuv-demo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prrao87%2Fuv-demo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/prrao87","download_url":"https://codeload.github.com/prrao87/uv-demo/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246297537,"owners_count":20754805,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["database","graph","graphdb","kuzu","rag","uv"],"created_at":"2024-12-11T10:07:34.659Z","updated_at":"2026-05-11T06:01:36.132Z","avatar_url":"https://github.com/prrao87.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Exploring `uv`: The 10x Python Package Manager\n\nThis repository contains code to demonstrate the basic features and ease of use of the\n[`uv` package manager](https://docs.astral.sh/uv/).\n\nWe will demonstrate how simple it is to set up and run `uv` by setting up a project whose virtual environment\ninvolves a non-trivial dependency resolution stage. In the example `requirements.txt` file, we have a\ndependency on `kuzu`, `lancedb`, `llama-index`, `polars`, `pyarrow`, `python-dotenv`, `numpy`, and `pyarrow`,\nwhich themselves have a host of inter-dependencies that may or may not conflict with each other.\n\nEarlier, you may have used `pip` or `poetry` for such a task. `uv` is a 10x package and project manager\nfor Python that makes all of this much faster, while unifying the experience of what earlier required\na host of different tools.\n\n## Setup\n\nThe Python version we will use is 3.12. You can install `uv` using the following commands, depending\non your operating system:\n\n```bash\n# On macOS via Homebrew\nbrew install uv\n\n# On Linux\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n\n# On Windows\npowershell -c \"irm https://astral.sh/uv/install.ps1 | iex\"\n```\n\n## Initialize the project\n\n```bash\nuv init\n```\n\nThis creates a new `pyproject.toml` file in the root of the project.\n\nIf you already have a `pyproject.toml` file as part of an existing project that was generated by someone\nelse, you can sync the dependencies in the `pyproject.toml` file to the local virtual environment by running:\n\n```bash\nuv sync\n```\n\nWhen using a `requirements.txt` file, you can add all of its dependencies to the existing\n`pyproject.toml` file:\n\n```bash\nuv add -r requirements.txt\n```\n\nAlternatively, you can add new dependencies manually as needed:\n\n```bash\n# Example of installing specific packages\nuv add polars\nuv add kuzu\n# ...\n```\n\nThe dependencies in `pyproject.toml` file and its associated lock file `uv.lock` are installed\nin a local virtual environment, in the directory `.venv`. To share the dependencies in a\nplatform-agnostic manner with your collaborators, you can simply commit the `uv.lock` file and\n`pyproject.toml` to your repository, and this will allow them to reproduce the same environment \non their own machines by running `uv sync` on their own machines.\n\n\u003e [!NOTE]\n\u003e If you are relying on `uv` to manage your Python version, **you do not need to worry about virtual\n\u003e environments** at all! You can simply run `uv run \u003cscript\u003e` and `uv` will use the Python version\n\u003e specified in your `pyproject.toml` file, and set up and manage the virtual environment for you.\n\n## Running the demo\n\nYou can execute the `hello.py` script by running the following command:\n\n```bash\nuv run hello.py\n```\n\nThis is very similar to running `python hello.py` or `python3 hello.py` in the terminal, but under the hood,\n`uv` is performing a whole host of steps, including the following:\n\n1. Installs Python if it's not already installed\n2. Creates and activates the virtual environment\n3. Installs the dependencies\n4. Runs the code\n\nThis is a very simple example, but hopefully, it demonstrates how `uv` can make it so much easier to\nmanage multiple Python versions, local virtual environments and all your project's dependencies.\nHave fun using uv, and spread the word!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprrao87%2Fuv-demo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprrao87%2Fuv-demo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprrao87%2Fuv-demo/lists"}