Metadata-Version: 2.3
Name: swarmake
Version: 0.1.2
Summary: The OpenSwarm Implementation.
Project-URL: Homepage, https://github.com/openswarm-eu/swarmake
Project-URL: Bug Tracker, https://github.com/openswarm-eu/swarmake/issues
Author-email: Geovane Fedrecheski <geovane.fedrecheski@inria.fr>
License: BSD
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.7
Requires-Dist: click==8.1.7
Requires-Dist: rich==13.8.1
Requires-Dist: structlog==24.4.0
Requires-Dist: toml==0.10.2
Requires-Dist: tqdm==4.66.5
Description-Content-Type: text/markdown

# OpenSwarm implementation

Fetch, build, and run the OpenSwarm.

For help, use `swarmake [command] --help`.

# Examples

## Build
Build the DotBot firmware:
```bash
# clone the dotbot repo and build it in Docker, using the recipe defined in swarmake.toml
swarmake build dotbot
```

Build the Coaty Data Distribution Agent:
```bash
# clone the repo and prepare the docker image
swarmake build dotbot
```

## Run
Build and run the `lakers` library:
```bash
# clone the lakers repo and build it using the recipe defined in swarmake.toml
# when stderr is redirected, we suppress stdout too and just show a "loading" line
swarmake build lakers 2> /dev/null
# run according to swarmake.toml
swarmake run lakers
```

## Deploy
Deploy a Swarm of DotBots:
```bash
swarmake deploy move --monitor
```

The command above will:
1. clone & build the dotbot and swarmit projects
2. flash the firmware to one or more available dotbots
3. start the experiment (i.e. run the firmware)
4. keep monitoring logs sent from dotbots
