Before you begin, ensure you have the following installed:
- Python: Version specified in
.python-version(e.g., Python 3.9+). Check your version withpython --version - uv: A fast Python package installer and resolver
pip install uv # Or, for global installation: # pipx install uv
Follow these steps to set up the HIFI-API project locally:
-
Clone the repository:
git clone <your-repository-url> cd hifi-api
-
Set up Environment Variables: Create a
.envfile in the root directory by copying the example file:cp .env.example .env
Open the newly created
.envfile and fill in the necessary environment variables, especially your Firebase credentials and any other API keys. -
Install Dependencies: Use uv to synchronize and install the project dependencies. This will also create a virtual environment (
.venv) if it doesn't exist:uv sync
-
Run The Serivce: Use uvicorn to run the fastapi server
uvicorn app.main:app --reload