Loan Agent

A multi-service loan processing application with a Streamlit frontend and multiple FastAPI backend services.

Prerequisites

• Python 3.8 or higher
• pip (Python package installer)

Installation

1. Navigate to the project directory:

cd 'Loan Agent'

2. Create a virtual environment:

python -m venv .venv

3. Activate the virtual environment:

Windows:

.\.venv\Scripts\activate

Linux/Mac:

source .venv/bin/activate

4. Install dependencies:

pip install -r requirements.txt

Running the Application

The application consists of multiple services that need to be run simultaneously. Open separate terminal windows for each service.

1. Start the Streamlit Frontend

streamlit run app.py

The frontend will be available at http://localhost:8501

2. Start the Offer Mart Server

uvicorn offer_mart_server:app --host 0.0.0.0 --port 8000 --reload

API available at http://localhost:8000

3. Start the KYC Server

uvicorn kyc_server:app --host 0.0.0.0 --port 8001 --reload

API available at http://localhost:8001

4. Start the Credit API Server

uvicorn credit_api:app --host 0.0.0.0 --port 8002 --reload

API available at http://localhost:8002

Service Architecture

• Frontend (Port 8501): Streamlit-based user interface
• Offer Mart Server (Port 8000): Handles loan offers and marketplace operations
• KYC Server (Port 8001): Manages Know Your Customer verification
• Credit API (Port 8002): Processes credit checks and scoring

Development

All services are configured with --reload flag for automatic restart on code changes during development.

Troubleshooting

• Ensure all required ports (8000, 8001, 8002, 8501) are available
• Make sure the virtual environment is activated before running any service
• Check that all dependencies are installed correctly

License

[Add your license information here]

Contact

[Add your contact information here]