This application was developed and tested on a Linux/WSL2 environment. Functionality on other operating systems has not been tested and is not guaranteed.
- Operating System: Linux / WSL2
- Python 3.10.12: We recommend using
pyenv
for managing Python versions. Ifpyenv
is not installed, you can install it following the instructions here. After installingpyenv
, you can install Python 3.10.12 usingpyenv install 3.10.12
. - Recomended enviroment manager is pipenv, but its not mandatory.
- Follow this instructions
- Clone the repository
- Navigate to the project directory
- Set the local Python version to 3.10.12
- Create and activate new virtual environment
- Install the required dependencies:
pipenv install
orpip install -r requirements.txt
- To run the application for video processing:
streamlit run app.py
At first, you need have collected some dataset. How should looks annotations, check official docs from ultralytics. Images do not have to be in the same resolution, or format. The only thing you need to pay attention to is that a file with annotations (dog.txt) is available in the same folder for each image (dog.png)
- Create in root directory this structure:
data/dataset
- Inside of
dataset
directory add images (supported formats arejpg
andpng
) and anotations (txt
) files - Into
data
directory insertobj.names
file - Be sure that you can run
Jupyter Notebooks
on your machine - Open
data_processing.ipynb
and run it. - Script will create some new directories in
data
directory and will do some magic there
- Be sure that your machine is supported and you have installed
CUDA 12.1
. - Run
train.py
script - Go to sleep, or make coffee bcs this will take some time....
- If training will be success, new model will be created and sreamlit app will find it and will use this model as default.
Contributions are welcome! Please feel free to submit a pull request.
If you are using Visual Studio Code as your IDE, you may need to specify the path to the Python interpreter in the .code-workspace
file..
Here's how you can do it:
- Open the
.code-workspace
file in your workspace. - Look for the
settings
object - Inside the
settings
object, add or modify thepython.defaultInterpreterPath
property. The value should be the absolute path to the Python interpreter you want to use.
This project is licensed under the MIT License.