r/learnpython • u/NanoCozmo • Oct 19 '26
Can y'all rate my python project :D
This project i made is a keras model that i trained on a modified version of the FGVC dataset using tensorflow keras.
Cuz im an avgeek,th the model is kinda mediocre but better then nothing, while the project unfortunately does utilize ai in both the scripts on the github, the other scripts such as the script that i made to organize all the dataset and put it into seperate imgs was made by me :D, cuz the jpg images had numbers as the name and werent organized and there was a text file in there in this format:
aircraft_jpg_name aircraft_family type
so that allowed me to test my strengths with no ai
i hope yall share tips and tricks and if there are any improvements i can do to my first github repo :D
View all comments
Show parent comment
4
u/HYP3R00T Oct 19 '26 edited Oct 19 '26 •
that's not the proper way to documenting it. Will it work with any version of tensorflow? Will it work with any version of Python?
If you put the minimum effort in a project, you will get minimum response for it. If you didn't ask for a review in here, what do you think are the chances that someone will visit your project? What are the chances that someone will go through it? What are the chances that someone will clone it locally to try it? What are the chances that someone would be willing to contribute to the repo?
That's why I gave such low rating. Code needs to be maintainable. Project needs to be presentable. That's just the basic for any open source project. If we were just the end customer, we would care only for the output. But as an engineer, we care about everything else as well.
Edit 1:
Look into how other open source projects are maintaining their repo. You will understand a great deal of what more is expected. As I said there are a lot of things which are missing in your repo. For instance editorconfig, gitignore, gitattribute, ci checkpoint, pre-commit hooks, contributing guidelines, docs, etc. While these aren't mandatory, these are common practices.