Skip to content

Commit bfc8e11

Browse files
committed
updated readme
1 parent d63a5bd commit bfc8e11

1 file changed

Lines changed: 8 additions & 11 deletions

File tree

README.md

Lines changed: 8 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -7,10 +7,11 @@ A custom, lightweight implementation of a Slither-like environment designed spec
77
This repository provides a sandbox environment where a snake agent must navigate a field, consume food to grow, and avoid colliding with other snakes. It is built to be highly configurable, supporting both rendered play for visualization and "headless" modes for accelerated RL training.
88

99
## Project structure
10-
- `src/`: The engine of the game. Contains the core logic (`game.py`) and helper functions (`utils.py`).
10+
- `src/slithbot`: The engine of the game. Contains the core logic (`game.py`), helper functions (`utils.py`), and entrypoint code (`main.py`).
1111
- `config/`: YAML files to easily tweak game parameters like world size, snake count, and rendering options.
12-
- `scripts/`: Entry points to execute the environment.
13-
- `requirements.txt`: Python dependencies needed to get up and running.
12+
- `tests/`: Testing code for the various functions in the project.
13+
- `pyproject.toml`: Configuration file for appropriate installation. Just run `pip install .` to install.
14+
- `docs/`: Some images etc. used in the project.
1415

1516
## Getting started
1617

@@ -22,20 +23,16 @@ git clone https://github.com/shashkat/slithbot.git
2223
cd slithbot
2324
conda create -n slithbot_env python=3.12
2425
conda activate slithbot_env
25-
pip install -r requirements.txt
26+
pip install . # for editable install, use: pip install -e .
2627
```
2728

2829
### Running the game
2930

30-
To see the environment in action using the default configuration, run:
31+
To see the environment in action using the default configuration, run from the cloned repo's root location:
3132

32-
`python scripts/run_game.py`
33+
`slithbot-run config/base.yaml`
3334

34-
### Configuration
35-
36-
You can swap out configurations to change how the environment behaves. For example, to run without rendering (ideal for training):
37-
38-
`python scripts/run_game.py config/no_render.yaml`
35+
Similarly, you can execute with other configurations. See the base configurations present in `slithbot/config`. Feel free to create your own configurations.
3936

4037
## Gameplay demo
4138

0 commit comments

Comments
 (0)