AI-assisted financial governance and dispute resolution platform for Chamas and informal savings groups in Africa.
# Run & Deploy ChamaOS
Everything you need to run the ChamaOS application locally.
## Live AI Studio App
View the deployed application in AI Studio:
:contentReference[oaicite:0]{index=0}
---
# Local Development Setup
## Prerequisites
Make sure you have installed:
- Node.js 18+
- npm or yarn
- Gemini API Key
---
# Installation
## 1. Clone the Repository
```bash
git clone
github.com
cd chamaos
```
---
## 2. Install Dependencies
```bash
npm install
```
---
## 3. Configure Environment Variables
Create a `.env.local` file in the project root:
```env
GEMINI_API_KEY=your_gemini_api_key
```
---
## 4. Start the Development Server
```bash
npm run dev
```
---
# Access the Application
Open your browser and visit:
```bash
localhost
```
---
# Production Deployment
To build the application for production:
```bash
npm run build
npm start
```
---
# Tech Stack
- Next.js
- TypeScript
- Gemini API
- TailwindCSS
- AI Studio
---
# Notes
- Ensure your Gemini API key is valid and has API access enabled.
- Never commit `.env.local` files to GitHub.
- Recommended Node.js version: 18 or higher.