Skip to content

Install

The first step is to set up your project and add Asyncer.

Install uv, then create a project and add Asyncer:

$ uv init awesome-project --bare
$ cd awesome-project
$ uv add asyncer
---> 100%

uv add creates the project's virtual environment in .venv, adds Asyncer to pyproject.toml, and creates uv.lock so the same package versions can be installed later.

What these commands do
  • uv init: create a new Python project.
  • awesome-project: create the project in a new directory with this name.
  • --bare: create only the minimal pyproject.toml file, without generating a sample main.py, README.md, or other files. You will create the application files yourself in the next steps of this tutorial.

Then cd awesome-project enters the new project directory before adding Asyncer.

uv will use a compatible Python version already installed on your system, or download one if needed.

When you run uv add, it selects compatible versions of Asyncer and all the packages Asyncer depends on. It records the exact versions in uv.lock, making it possible to install the same package versions later on another computer.

Creating or updating this file is called locking the project dependencies. uv does this automatically when you add a package.

Using pip instead

If you prefer to manage a virtual environment and packages manually, create and activate a virtual environment and then install Asyncer with pip install asyncer.

Read the Virtual Environments guide for the detailed steps.

AI Agent Skills

Asyncer includes an official skill for AI coding agents. It is bundled with the package, so its guidance stays aligned with the version of Asyncer installed in your project and updates when you update Asyncer.

After installing Asyncer in your project, you can install the skill with Library Skills:

uvx library-skills

Note

uvx is an alias for uv tool run. It runs Library Skills in a temporary, isolated environment while Library Skills scans the packages installed in your project.

The skill is compatible with Codex, Claude Code, Cursor, GitHub Copilot, Gemini CLI, Pi, OpenCode, and most other coding agents. For Claude Code, select .claude/skills when asked where to install the skill.