chore: document & enforce python runtime + add .env.example

[arceuzvx]

Summary

Contributors are encountering dependency resolution errors (e.g., TensorFlow pip errors) because the repository does not declare a supported Python runtime. This causes installations to fail on modern Python versions (>=3.11). We should declare a supported Python version, provide an .env.example, and add a minimal CI check to prevent environment friction for contributors.

Problem / Reproduction

1. On a machine running Python 3.11+:

   python --version
   pip install -r backend/requirements.txt

2. pip fails with messages such as:

     Could not find a version that satisfies the requirement tensorflow==2.17.0
     Ignored the following versions that require a different python version: 
   

3. This blocks new contributors from running the project locally and submitting PRs.

Proposal (minimal, high-impact)

1. Add a runtime declaration file: .python-version (content: 3.9.19) OR runtime.txt to explicitly declare the supported Python runtime (like: 3.9 or 3.10).
2. Add .env.example at repo root listing required environment variables (no secrets).
3. Update CONTRIBUTING.md or SETUP.md with one-line setup steps for conda/pyenv/venv so contributors can reproduce a working environment.

[github-actions]

Thanks for addressing the issue! We’ll review it and get back to you shortly. If it’s a feature request, consider adding screenshots or a demo video for clarity.

Join our Discord Community for discussions, questions, and real-time collaboration!

[PRANIT0605]

Please assign me this issue !

[SrigadaAkshayKumar]

@arceuzvx what files do you want add and what files do you want to change give me a list
and in setup.md need to add an .env file setup with firebase credentials like

You need to set up the .env file locally with your API keys. Have you done that?

here is the same format

REACT_APP_FIREBASE_API_KEY="xxxx(you credentials)"
REACT_APP_FIREBASE_AUTH_DOMAIN="xxxx(you credentials)"
REACT_APP_FIREBASE_DATABASE_URL="xxxx(you credentials)"
REACT_APP_FIREBASE_PROJECT_ID="xxxx(you credentials)"
REACT_APP_FIREBASE_STORAGE_BUCKET="xxxx(you credentials)"
REACT_APP_FIREBASE_MESSAGING_SENDER_ID="xxxx(you credentials)"
REACT_APP_FIREBASE_APP_ID="xxxx(you credentials)"
REACT_APP_FIREBASE_MEASUREMENT_ID="xxxx(you credentials)"

as many contributors facing in the setup issue so this issue has put in top priority i want this enhancement asap how many aporx days you need to complete this, i am expecting to complete this with 2days

if you want to work this drop a message asap so that i can assign

[arceuzvx]

The latest version of python used is 3.13.* but certain functions and modules only seem to work for versions 3.11 or lesser. ( tensorflow example given)

Also I'm currently facing issues with #18

Update: its running after adding firebase credentials

Can you assign me the task to update documentation work for now? I can do it ASAP.

[SrigadaAkshayKumar]

This issue needs to be completed on a priority basis and requires immediate attention. Please make sure to complete it within 2 days.