collabsort-agent

An agent for a collaborative sorting task.

Installation

uv needs to be available on your system.

git clone https://github.com/bpesquet/collabsort-agent
cd collabsort-agent
uv sync

Usage

This project uses tyro to easily obtain configuration values from the CLI.

# Show all possible options for training
uv run python src/collabsort_agent/train.py --help

# Train the agent, using a configuration specified by {options}
uv run python src/collabsort_agent/train.py {options}

Development notes

This project is built and tested with the following software:

• ruff for code formatting and linting;
• ty for type checking;
• pytest for testing.

Useful commands

# Format all Python files
uvx ruff format

# Lint all Python files and fix any fixable errors
uvx ruff check --fix

# Check for type-related mistakes
uvx ty check

# Test the codebase. See pyproject.toml for pytest configuration.
# The optional -s flag prints code output.
# Code coverage reporting is configured in pyproject.toml
uv run pytest [-s]

License

MIT.

Copyright © 2025-present Baptiste Pesquet.