Welcome to SmartLend, a cutting-edge peer-to-peer lending platform designed to connect borrowers and lenders seamlessly. Whether you're seeking a loan to fuel your dreams or looking to invest in opportunities, SmartLend leverages modern technology—machine learning, and a robust full-stack architecture—to make lending smarter, faster, and more secure.
- Borrower Empowerment: Apply for loans with an intuitive dashboard and streamlined application process.
- Lender Opportunities: Fund loans, track investments, and review agreements through a dedicated lender portal.
- Smart Evaluation: Machine learning (XGBoost) powers credit scoring and loan approval decisions.
- Secure & Transparent: Firebase-backed authentication and MongoDB for reliable data management.
- Real-Time Tracking: Monitor repayments, transactions, and loan statuses effortlessly.
- Frontend: React, Tailwind CSS, Firebase (authentication & config)
- Backend: Node.js, Express.js, MongoDB
- Machine Learning: Python, XGBoost (
xgb_model.pkl) - OCR Service: Node.js
- Tools: Git, npm, pip
📦 SmartLend
├─ .gitignore # Git ignore rules
├─ Mongobackend # Mixed Python/Node.js backend (possibly experimental)
│ ├─ api # API endpoint for ML model
│ ├─ database # MongoDB integration (mongo_client.py)
│ ├─ mlServer.py # ML server (Python)
│ ├─ ml_models # ML model storage
│ ├─ requirements.txt # Python dependencies
│ ├─ schemas.py
│ ├─ services # Business logic (i.e loan evaluation)
│ └─ updated_backend # Node.js backend (updated version?)
│ ├─ .env # Environment variables
│ ├─ config
│ ├─ controllers # Request handlers
│ ├─ package.json # Node.js dependencies
│ ├─ routes # API routes
│ ├─ server.js # Main server script
│ └─ xgb_model.pkl # ML model copy
├─ frontend # React frontend
│ ├─ public # Static assets
│ ├─ src # Source code
│ │ ├─ assets # Images (e.g., SmartLend logos)
│ │ ├─ components # Reusable UI components
│ │ ├─ pages # Page components
│ │ ├─ firebaseConfig.js # Firebase setup
│ │ └─ [other files] # App logic, styles, etc.
│ ├─ package.json # Dependencies
│ └─ tailwind.config.js # Tailwind CSS config
├─ README.md # You’re reading it!
└─ package.json # Root-level dependencies (if any)
Follow these steps to set up SmartLend locally:
- Node.js
- Python (3.9+ for ML components)
- npm (comes with Node.js)
- pip (Python package manager)
- Git
-
Clone the Repository
git clone https://github.com/yourusername/smartlend.git cd smartlend -
Set Up Each Component
-
Frontend
cd frontend npm install- **Mongobackend **
cd Mongobackend pip install -r requirements.txt cd updated_backend npm install
-
OCR Backend
cd ocr_backend npm install
-
-
Configure Environment Variables
- Create
.envfiles inbackend,updated_backend, andocr_backendwith required keys (e.g.,MONGO_URI,FIREBASE_API_KEY,ML_MODEL_PATH).
- Create
-
Run the Services
- Frontend
cd frontend npm start # Runs on http://localhost:3000
- Mongobackend
cd Mongobackend uvicorn mlServer:app --reload # Python backend cd updated_backend node server.js # Node.js backend
- OCR Backend
cd ocr_backend node index.js
- Frontend
- Access the App: Open
http://localhost:3000in your browser. - Sign Up/Login: Create an account as a borrower or lender.
- Borrowers: Navigate to the loan application page, apply for loan and track your application.
- Lenders: Browse loan listings, fund opportunities, and monitor your portfolio.
We’d love your help to make SmartLend even better!
- Fork the repo.
- Create a branch:
git checkout -b branch_new. - Commit your changes:
git commit -m "Add new branch". - Push to your branch:
git push origin branch_new. - Open a Pull Request with a clear description.
- Email: smartlend25@gmail.com
Built with 💻 and ❤️ by the SmartLend Team.
