Skip to content

Commit

Permalink
Merge pull request #5 from goeckslab/Installation_Documentation
Browse files Browse the repository at this point in the history
Update README.md for installation documentation
  • Loading branch information
qchiujunhao committed Mar 22, 2024
2 parents cf9f6a1 + 3a8d5cf commit 8cc5c50
Showing 1 changed file with 31 additions and 0 deletions.
31 changes: 31 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,33 @@
# Galaxy-Ludwig
A library of Galaxy deep learning tools based on Ludwig.

# Install Galaxy-Ludwig into Galaxy
We assume that you have Galaxy running and docker installed in your server/laptop.
* Create a new folder named ludwig(or whatever) under Galaxy’s tools folder.
* Copy all XML, py files under the tools folder in this repo to the ludwig folder(the folder you created in the last step).
* Update `tool_conf.xml` to include Galaxy-Ludwig. See [documentation](https://docs.galaxyproject.org/en/master/admin/tool_panel.html) for more details. This is an example:
```
<section id="ludwig" name="Ludwig Applications">
<tool file="ludwig/ludwig_evaluate.xml" />
<tool file="ludwig/ludwig_experiment.xml" />
<tool file="ludwig/ludwig_hyperopt.xml" />
<tool file="ludwig/ludwig_predict.xml" />
<tool file="ludwig/ludwig_render_config.xml" />
<tool file="ludwig/ludwig_train.xml" />
<tool file="ludwig/ludwig_visualize.xml" />
</section>
```

* Configure the `job_conf.yml` under `lib/galaxy/config` to enable the docker for the environment you want the Ludwig related job running in. This is an example:
```
execution:
default: local
environments:
local:
runner: local
docker_enabled: true
```
If you are using an older version of Galaxy, then `job_conf.xml` would be something you want to configure instead of `job_conf.yml`. Then you would want to configure destination instead of execution and environment.
See [documentation](https://docs.galaxyproject.org/en/master/admin/jobs.html#running-jobs-in-containers) for job_conf configuration.
* If you haven’t set `sanitize_all_html: false` in `galaxy.yml`, please set it to False to enable our HTML report functionality.
* Should be good to go.

0 comments on commit 8cc5c50

Please sign in to comment.