Installation

Requirements¶

Python 3.12.* (due to a regression in asyncio)
Poetry >=2.0.0

Preparing the challenge environment¶

Note

If you are using IDE, such as PyCharm, it may be easier for you to just create a new Poetry project within the IDE, add aica-challenge-1 as a dependency, and then just jump to starting the TUI. Otherwise, continue reading.

To prepare the challenge environment, you should create a separate directory for your challenge code, and initialize Poetry, as it will be taking care of the dependency management.

  $ mkdir test_challenge
  $ cd test_challenge
  $ poetry init --python="==3.12.*" --dependency="aica-challenge-1"

Once you run the poetry init command, you will have to fill in a couple of fields that will be going into your pyproject.toml file. However, as we are using Poetry only for dependency management, the actual contents are not important and the defaults are reasonable enough, it should be safe to just press enter (and skip dependency selection) until the file is created.

The init process should look like this:

And the resulting pyproject.toml should look like this:

[project]
name = "test-challenge"
version = "0.1.0"
description = ""
authors = [
    {name = "Martin Drasar",email = "drasar@ics.muni.cz"}
]
readme = "README.md"
requires-python = "==3.12.*"
dependencies = [
    "aica-challenge-1 (>=1.0.0,<2.0.0)"
]


[build-system]
requires = ["poetry-core>=2.0.0,<3.0.0"]
build-backend = "poetry.core.masonry.api"

When your Poetry config is to your liking, just install the dependencies ...

  $ poetry update

... and start the challenge TUI:

  $ poetry run aica_challenge

For the first run, you will be greeted with the following screen:

While you could experiment with running this from another path, the surest way is to select the first option.

After you initialize the challenge environment, you will see the following menu, and you can consider the challenge installed and ready.

Now, if you want, you can start by creating your own agent, or you can familiarize yourself with the rest of the challenge environment.