Description:
The repository currently lacks a README.md file. A well-structured README is the front page of our project and is critical for onboarding new developers, open-source contributors, and stakeholders. It needs to clearly explain what the project is, the technologies it uses, and provide step-by-step instructions for running it locally.
Tasks & Implementation Details:
Create a README.md file in the root directory that includes the following sections:
- Project Title and Description:
- Briefly describe the "MIFOS X AI Sentiment Analysis & Dynamic Loan Pricing Module". Explain how it uses Reinforcement Learning (RL) and Large Language Models (Ollama) to automate and explain loan pricing.
- Architecture & Tech Stack:
- Clearly list the core technologies: FastAPI (Backend API), Streamlit (Frontend Dashboard), SQLAlchemy/SQLite (Database), Stable-Baselines3 / PyTorch (RL models), and Ollama (Local LLM Explainability).
- Prerequisites:
- Mention the software required to run the project:
Python 3.10+, Git, and Ollama (with instructions to pull gemma2:2b or llama3).
- Local Installation & Setup:
- Provide exact terminal commands to clone the repo, create a virtual environment (
.venv), and install dependencies (pip install -r requirements.txt).
- Running the Application (Without Docker):
- Backend: Provide the command to start the API:
export PYTHONPATH=$(pwd)
python -m uvicorn backend.main:app --host 0.0.0.0 --port 8000 --reload
- Frontend: Provide the command to start the dashboard:
export PYTHONPATH=$(pwd)
python -m streamlit run dashboard/app.py --server.port 8501
- Project Structure:
- Include a brief text-based folder tree explaining where the backend API (
/backend), Streamlit pages (/dashboard), database models (/database), and RL training scripts (/training) live.
- Docker Instructions (Optional but recommended):
- Explain how to use the existing
docker-compose.yml to spin up the services with a single docker-compose up --build command.
Acceptance Criteria:
- The
README.md uses standard Markdown formatting (headers, code blocks, bold text).
- A new developer can follow the copy-paste instructions to successfully run both servers locally without errors.
- The documentation explicitly mentions the Ollama local dependency (port 11434).
Description:
The repository currently lacks a
README.mdfile. A well-structured README is the front page of our project and is critical for onboarding new developers, open-source contributors, and stakeholders. It needs to clearly explain what the project is, the technologies it uses, and provide step-by-step instructions for running it locally.Tasks & Implementation Details:
Create a
README.mdfile in the root directory that includes the following sections:Python 3.10+,Git, andOllama(with instructions to pullgemma2:2borllama3)..venv), and install dependencies (pip install -r requirements.txt)./backend), Streamlit pages (/dashboard), database models (/database), and RL training scripts (/training) live.docker-compose.ymlto spin up the services with a singledocker-compose up --buildcommand.Acceptance Criteria:
README.mduses standard Markdown formatting (headers, code blocks, bold text).