Add poetry setup to CONTRIBUTING.md

[planetf1]

The CONTRIBUTING.md has information on creating a virtual environment and setting up the tools needed for Bee

After creating a virtual environment and activating, the docs include an invocation of poetry shell. However at this point poetry is likely not installed. Additionally, the 'shell' command is now in a plugin.

We could add
pip install poetry poetry-plugin-shell

However, in addition, poetry shell does not create a virtual environment - this would also need adding (Note: am unfamilar with poetry)

python -m venv .venv 

This will help a new contributor get their environment sorted more quickly.

Since a similar CONTRIBUTING.md is used in other parts of the bee stack we may wish to update elsewhere (or link together)?

That being said, we don't yet have a pyproject.toml so poetry shell will not (yet) work ...

[psschwei]

The contributing doc implicitly focuses on the python bee agent more than the hive (indeed, hive hasn't been configured to use poetry yet as you mention), so we'll need to update that.

Also worth noting that the recommended way to setup poetry is via pipx, which will install in a virtual environment so as not to break system Python but allow poetry to be used globally. Once that's done, running poetry shell will create a new virtual environment when run from a directory with a pyproject.toml:

$ cd /tmp

$ git clone [email protected]:i-am-bee/bee-hive.git
Cloning into 'bee-hive'...
remote: Enumerating objects: 389, done.
remote: Counting objects: 100% (138/138), done.
remote: Compressing objects: 100% (110/110), done.
remote: Total 389 (delta 46), reused 65 (delta 25), pack-reused 251 (from 1)
Receiving objects: 100% (389/389), 504.44 KiB | 5.31 MiB/s, done.
Resolving deltas: 100% (128/128), done.

$ cd bee-hive/framework/bee-py/

$ poetry shell
Creating virtualenv bee-agent-hWeAOn7W-py3.12 in /home/paul/.cache/pypoetry/virtualenvs
Spawning shell within /home/paul/.cache/pypoetry/virtualenvs/bee-agent-hWeAOn7W-py3.12
. /home/paul/.cache/pypoetry/virtualenvs/bee-agent-hWeAOn7W-py3.12/bin/activate

[planetf1]

Adding a note that the shell is not part of a standard poetry install (any more). After the pipx it can be installed with poetry self add poetry-plugin-shell