ai-awesome-project-template


# 🤖 AI Awesome Project Template

👋 Template author

______________________________________________________________________ You may want to adjust badge links in a README.md file. [![ci-testing](https://github.com/wiktorlazarski/ai-awesome-project-template/actions/workflows/ci-testing.yml/badge.svg?branch=main&event=push)](https://github.com/wiktorlazarski/ai-awesome-project-template/actions/workflows/ci-testing.yml) [![Open In Collab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/pytorch/ignite/blob/master/examples/notebooks/FashionMNIST.ipynb) [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black) [![license](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://github.com/wiktorlazarski/ai-awesome-project-template/blob/master/LICENSE)

💎 Installation with pip

Installation is as simple as running:

pip install git+https://github.com/wiktorlazarski/ai-awesome-project-template.git

⚙️ Setup

Before setting up a project, make sure that the setup.py script has all setup parameters adjusted and change an ai_awesome directory name to your project name. Also, if you want to use conda environment, you may want to change its name in a conda_env.yml file. Then, follow the instruction:

# Clone repo
git clone https://github.com/wiktorlazarski/ai-awesome-project-template.git

# Go to repo directory
cd ai-awesome-project-template

# (Optional) Create virtual environment
python -m venv venv
source ./venv/bin/activate

# Install project in editable mode
pip install -e .[dev]

# (Optional but recommended) Install pre-commit hooks to preserve code format consistency
pre-commit install

🐍 Setup with Anaconda or Miniconda

Before setting up a project, make sure that the setup.py script has all setup parameters adjusted and change an ai_awesome directory name to your project name. Additionally, you may want to change a default (ai_awesome_env) conda environment name in a conda_env.yml file. Then, follow the instruction:

# Clone repo
git clone https://github.com/wiktorlazarski/ai-awesome-project-template.git

# Go to repo directory
cd ai-awesome-project-template

# Create and activate conda environment
conda env create -f ./conda_env.yml
conda activate ai_awesome_env

# (Optional but recommended) Install pre-commit hooks to preserve code format consistency
pre-commit install
### 🤗 Happy coding !