Skip to content

Commit

Permalink
Merge pull request #91 from ANNUBS/update_installation_docs_gcroci2
Browse files Browse the repository at this point in the history
docs: add pypi installation
  • Loading branch information
gcroci2 committed May 14, 2024
2 parents 0dc7c68 + 8f2af91 commit 0be5017
Show file tree
Hide file tree
Showing 2 changed files with 29 additions and 13 deletions.
22 changes: 15 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,8 +33,8 @@ Please note that this software is currently in its early stages of development.
- [Overview](#overview)
- [Table of contents](#table-of-contents)
- [Installation](#installation)
- [Repository installation](#repository-installation)
- [Pip installation](#pip-installation)
- [Repository installation](#repository-installation)
- [Get started](#get-started)
- [Generate synthetic data](#generate-synthetic-data)
- [Train neural networks](#train-neural-networks)
Expand All @@ -44,21 +44,29 @@ Please note that this software is currently in its early stages of development.

## Installation

### Repository installation
We advise to install the package inside a virtual environment (using [conda](https://conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html) or [venv](https://docs.python.org/3/library/venv.html)). Make sure to create an environment containing a Python version >=3.11 and `pip` package installer.

We advise to install the package inside a virtual environment (using [conda](https://conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html) or [venv](https://docs.python.org/3/library/venv.html)).
After having created and activated your environment, you have two ways for installing ANNUBeS.

After having created and activated your environment, to install ANNUBeS from GitHub repository, do:
### Pip installation

This is the **recommended installation for users**.

```console
pip install annubes
```

This command will install the latest version of the package [deployed on PyPI](https://pypi.org/project/annubes/).

### Repository installation

```console
git clone git@github.com:ANNUBS/annubes.git
cd annubes
pip install .
```

### Pip installation

Under development.
The above commands will install the most recent version of the repository, using the default branch (main).

## Get started

Expand Down
20 changes: 14 additions & 6 deletions docs/installation.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,25 @@
# Installation

## Repository installation
We advise to install the package inside a virtual environment (using [conda](https://conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html) or [venv](https://docs.python.org/3/library/venv.html)). Make sure to create an environment containing a Python version >=3.11 and pip package installer.

After having created and activated your environment, you have two ways for installing ANNUBeS.

We advise to install the package inside a virtual environment (using [conda](https://conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html) or [venv](https://docs.python.org/3/library/venv.html)).
## Pip installation

After having created and activated your environment, to install ANNUBeS from GitHub repository, do:
This is the **recommended installation for users**.

```console
pip install annubes
```

This command will install the latest version of the package [deployed on PyPI](https://pypi.org/project/annubes/).

## Repository installation

```console
git clone git@github.com:ANNUBS/annubes.git
cd annubes
pip install .
```

## PyPI installation

Under development.
The above commands will install the most recent version of the repository, using the default branch (main).

0 comments on commit 0be5017

Please sign in to comment.