# A simple webframework based in Bottle and Mako for create nice webapps

# Installation

This guide give you step by step for install cuchulu sucessfully.

## Requirements

For install Paramecio you need a server preferably with GNU/Linux installed. Paramecio is tested normally in Debian derivated how Ubuntu, and Red hat derivated distros how Centos or Fedora but should work fine in FreeBSD, MacOSX and other *nix like operating systems.

Also, you need the next software installed  in  your os:

### Python 3.4 or later. 

Paramecio should work fine since python 3.6 but is tested in 3.12 and 3.13 python 3 versions.

In Debian and Ubuntu you can install Python 3 using the next command: `apt-get install python3`.

In Fedora and other Red Hat derived distros you can use `dnf install python3`. 

### MySQL or MariaDB database servers. 

MariaDB 10.6 and later are recommended.

In Debian and Ubuntu you can install MariaDB using the next command: `apt-get install mariadb-server`.

In Fedora and other Red Hat derived distros you can use `dnf install mariadb-server`. 

### Pip

Pip is the package manager of python. You can use the package manager of your os for get python dependencies packages but in my experience is better install the packages directly with pip. 

In Debian and Ubuntu you can install pip using the next command: `apt-get install python3-pip`.

In Fedora and other Red Hat derived distros you can use `dnf install python3-pip`. 

### Git

[Git](https://git-scm.com/) is a tool used for manage source code repositories. Also is a tool that can be used for distribute software. For install the next tools you need git installed in your server.

In Debian and Ubuntu you can install git using the next command: `apt-get install git`.

In Fedora and other Red Hat derived distros you can use `dnf install git`.

## Install Paramecio Framework

You can install the framework using the next command in your server:

`pip3 install cuchulu`

or if you want development version:

`pip3 install git+https://bitbucket.org/cuchulu/cuchulufm`

This command will install in your server cuchulu framework with its dependencies.

When Paramecio finish the installing, you can create your first cuchulu site with `cuchulu` command.

### Tipical errors

If you get an error in your installation of dependencies how MarkupSafe or SqlAlchemy, please install gcc or install manually mako and sqlalchemy with your system package manager. For example, for debian and ubuntu:

`apt-get install python3-mako python3-sqlalchemy` and try pip3 command again.

