= Debian and Ubuntu Linux =
Install AG Projects software signing key:
```sudo curl -o /etc/apt/trusted.gpg.d/agp-debian-key.gpg http://download.ag-projects.com/agp-debian-key.gpg```
If you don't have Curl:
```sudo wget -O /etc/apt/trusted.gpg.d/agp-debian-key.gpg http://download.ag-projects.com/agp-debian-key.gpg```
Add the following lines to `/etc/apt/sources.list`:
Ubuntu Bionic Beaver:
```
deb http://ag-projects.com/ubuntu bionic main
deb-src http://ag-projects.com/ubuntu bionic main
```
Ubuntu Cosmic Cuttlefish:
```
deb http://ag-projects.com/ubuntu cosmic main
deb-src http://ag-projects.com/ubuntu cosmic main
```
Debian Stable (Stretch):
```
deb http://ag-projects.com/debian stretch main
deb-src http://ag-projects.com/debian stretch main
```
Debian Unstable:
```
deb http://ag-projects.com/debian unstable main
deb-src http://ag-projects.com/debian unstable main
```
To install or upgrade a software package:
```
sudo apt-get update
sudo apt-get install package_name
```
Replace `package_name` with the name of the software package.
= Tar Archives =
Some packages are available as tar archives:
http://download.ag-projects.com/
= Version Control Repositories =
The source code is managed using darcs version control tool. The darcs repository can be fetched with:
```
darcs get http://devel.ag-projects.com/repositories/PACKAGE_NAME
Replace PACKAGE_NAME with the name of the software package.
```
To obtain the incremental changes after the initial get run:
```
darcs pull -a
```
=Manual Installation=
All python software packages can be installed system-wide using:
```sudo python setup.py install```
= Debian Package Building=
Some of the packages are ready to be packaged for Debian like distributions by using this procedure:
Create under each repository a clean distribution file:
```
python setup.py sdist
```
Go to the `./dist` directory and untar the file created at the step above.
Go to the newly created directory and type:
```
debuild -us -uc
```
The .deb and related files are built in the upper directory.