Skip to content

Commit 11b4ea8

Browse files
Merge pull request #66 from TejasriMasina/project_structure
Project structure Improved
2 parents 28860c6 + b0fe92b commit 11b4ea8

10 files changed

+154
-72
lines changed

β€ŽBuild/tempβ€Ž

Lines changed: 0 additions & 1 deletion
This file was deleted.

β€ŽCONTRIBUTING.mdβ€Ž

Lines changed: 84 additions & 71 deletions
Original file line numberDiff line numberDiff line change
@@ -1,90 +1,103 @@
1-
Here’s a set of **Contribution Guidelines** tailored for your open-source project:
1+
# Contributing to AI-health-chatbot
22

3-
---
3+
Thank you for considering contributing to AI-health-chatbot! πŸŽ‰
4+
We welcome contributions of all types β€” bug fixes, feature implementations, documentation improvements, and feedback.
45

5-
# Contribution Guidelines
6+
-> These guidelines are here to make the process smooth and collaborative for everyone.
67

7-
Thank you for considering contributing to **Blok**! We welcome contributions of all types, including bug fixes, feature implementations, documentation improvements, and feedback. These guidelines are here to make the process clear and smooth for everyone.
8+
## πŸš€ How to Contribute
89

9-
---
10+
### 1. Discuss Your Idea
1011

11-
## How to Contribute
12+
* Before starting work on a major change, please open an **issue** in the repository.
13+
* Use the issue template (if available) or describe your idea clearly.
1214

13-
### 1. **Discuss Your Idea**
14-
- Before starting work on a major change, please open an issue in the repository.
15-
- Use the **#ideas-and-feedback** channel in our [Discord community](https://discord.gg/QXhHzw7azs) for discussions.
15+
### 2. Fork and Clone
1616

17-
### 2. **Fork and Clone**
18-
- Fork the repository to your GitHub account.
19-
- Clone the forked repository to your local machine.
17+
* Fork this repository to your GitHub account.
18+
* Clone the forked repository to your local machine:
2019

2120
```bash
22-
git clone https://github.com/YOUR_USERNAME/blok.git
23-
cd blok
21+
git clone https://github.com/CharithaReddy18/AI-health-chatbot.git
22+
cd AI-health-chatbot
2423
```
2524

26-
### 3. **Set Up Your Environment**
27-
- Follow the instructions in the `README.md` to set up your development environment.
28-
- Run tests to ensure everything works as expected.
29-
30-
### 4. **Work on Your Contribution**
31-
- Create a new branch for your work:
32-
```bash
33-
git checkout -b feature/your-feature-name
34-
```
35-
- Follow the coding style and conventions used in the project.
36-
- Write clear, concise, and well-documented code.
37-
- If adding a new feature, include relevant tests.
38-
39-
### 5. **Commit Your Changes**
40-
- Write meaningful commit messages:
41-
```bash
42-
git commit -m "Add: Feature description"
43-
```
44-
- Push your changes to your fork:
45-
```bash
46-
git push origin feature/your-feature-name
47-
```
48-
49-
### 6. **Submit a Pull Request**
50-
- Open a pull request from your branch to the `main` branch of the original repository.
51-
- Use the pull request template (if available) to provide details about your changes.
52-
- Ensure that all automated tests pass before submission.
53-
54-
---
55-
56-
## Code Style and Standards
57-
- Use ESLint to ensure code consistency.
58-
- Adhere to the project's architectural patterns and modular design principles.
59-
- Avoid introducing unnecessary dependencies.
60-
61-
---
62-
63-
## Reporting Issues
64-
If you encounter a bug or have a feature request:
65-
1. Check the Issues to ensure it hasn’t been reported.
25+
### 3. Set Up Your Environment
26+
27+
* Check the ['README.md'](README.md) for setup instructions.
28+
* Install requirements based on requirements.txt.
29+
30+
### 4. Work on Your Contribution
31+
32+
* Create a new branch for your work:
33+
34+
```bash
35+
git checkout -b feature/your-feature-name
36+
```
37+
38+
* Follow the coding style and conventions used in the project.
39+
* Write clear, well-documented code.
40+
* Add tests if applicable.
41+
42+
### 5. Commit Your Changes
43+
44+
* Use meaningful commit messages:
45+
46+
```bash
47+
git commit -m "Add: Short description of your change"
48+
```
49+
50+
* Push your changes:
51+
52+
```bash
53+
git push origin feature/your-feature-name
54+
```
55+
56+
### 6. Submit a Pull Request
57+
58+
* Open a Pull Request (PR) to the `main` branch of this repository.
59+
* Fill out the PR template (if available).
60+
* Make sure all checks/tests pass before requesting review.
61+
62+
63+
## 🧩 Code Style and Standards
64+
65+
* Use ESLint / Prettier (if configured) for consistent formatting.
66+
* Follow naming conventions and keep code modular.
67+
* Avoid introducing unnecessary requirements.
68+
69+
70+
## πŸ› Reporting Issues
71+
72+
If you find a bug or have a feature request:
73+
74+
1. Check the existing issues first.
6675
2. Open a new issue with:
67-
- A clear and descriptive title.
68-
- Steps to reproduce the issue (if applicable).
69-
- Expected and actual behavior.
7076

71-
---
77+
* A clear and descriptive title
78+
* Steps to reproduce (if it’s a bug)
79+
* Expected vs. actual behavior
80+
81+
82+
## πŸ“– Documentation Contributions
83+
84+
* Update relevant Markdown files (`README.md`, `docs/`) for docs-related changes.
85+
* Keep writing clear, concise, and beginner-friendly.
86+
87+
88+
## 🀝 Community and Conduct
89+
90+
* Be respectful and collaborative in all interactions.
91+
* Follow the project’s [Code of Conduct](CODE_OF_CONDUCT.md).
92+
7293

73-
## Documentation Contributions
74-
- For documentation edits, update the relevant markdown files in the `docs/` directory.
75-
- Follow a clear and concise writing style.
94+
## ❓ Need Help?
7695

77-
---
96+
If you have any questions:
7897

79-
## Community and Conduct
80-
- Be respectful and collaborative when interacting with others.
81-
- Adhere to the project's [Code of Conduct](CODE_OF_CONDUCT.md).
98+
* Open an issue with the `question` label.
99+
* Tag project maintainers for clarification.
82100

83-
---
84101

85-
## Need Help?
86-
If you have questions or need help, feel free to:
87-
- Join our [Discord community](https://discord.gg/QXhHzw7azs).
88-
- Open an issue with the `question` label.
102+
We’re excited to collaborate with you and improve **AI-health-chatbot** together! πŸ’‘
89103

90-
We’re excited to collaborate with you and improve **Blok** together!

β€ŽREADME.mdβ€Ž

Lines changed: 70 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -133,6 +133,63 @@ MediBot follows a modern, microservices-inspired architecture:
133133

134134
## πŸ“‚ Project Structure
135135

136+
137+
```plaintext
138+
AI-HEALTH-CHATBOT/
139+
β”œβ”€β”€ backend/ # FastAPI Backend Application
140+
β”‚ β”œβ”€β”€ app/
141+
β”‚ β”‚ β”œβ”€β”€ Medical_DataBase/ # Stores the FAISS vector index for the RAG model
142+
β”‚ β”‚ β”‚ β”œβ”€β”€ index.faiss
143+
β”‚ β”‚ β”‚ └── index.pkl
144+
β”‚ β”‚ β”œβ”€β”€ models/ # Pydantic schemas for data validation (schemas.py)
145+
β”‚ β”‚ β”œβ”€β”€ routers/ # Defines the API endpoints (e.g., /chat, /disease)
146+
β”‚ β”‚ β”‚ β”œβ”€β”€ chat.py
147+
β”‚ β”‚ β”‚ β”œβ”€β”€ disease.py
148+
β”‚ β”‚ β”‚ └── health.py
149+
β”‚ β”‚ β”œβ”€β”€ services/ # Contains the core business logic for all features
150+
β”‚ β”‚ β”‚ β”œβ”€β”€ disease_predictor.py
151+
β”‚ β”‚ β”‚ β”œβ”€β”€ health_info.py
152+
β”‚ β”‚ β”‚ β”œβ”€β”€ medical_agent.py # Manages the core RAG pipeline and LLM interaction
153+
β”‚ β”‚ β”‚ └── symptom_checker.py
154+
β”‚ β”‚ β”œβ”€β”€ utils/ # Utility and helper functions
155+
β”‚ β”‚ β”œβ”€β”€ config.py # Handles configuration and environment variables
156+
β”‚ β”‚ └── main.py # The main entry point to launch the FastAPI server
157+
β”‚ β”œβ”€β”€ data/ # Directory for raw data files like CSVs
158+
β”‚ └── requirements.txt # A list of all Python dependencies
159+
β”‚
160+
β”œβ”€β”€ client/ # React Frontend Application
161+
β”‚ β”œβ”€β”€ public/ # Contains static assets like the main index.html and icons
162+
β”‚ β”œβ”€β”€ src/
163+
β”‚ β”‚ β”œβ”€β”€ api/ # Functions for making HTTP requests to the backend
164+
β”‚ β”‚ β”œβ”€β”€ assets/ # Stores local assets like images, fonts, and CSS
165+
β”‚ β”‚ β”œβ”€β”€ components/ # Reusable React components (e.g., ChatWindow, Button)
166+
β”‚ β”‚ β”œβ”€β”€ pages/ # Components representing entire pages or views
167+
β”‚ β”‚ β”œβ”€β”€ App.jsx # The main root component of the application
168+
β”‚ β”‚ └── main.jsx # The entry point for the React application
169+
β”‚ β”œβ”€β”€ package.json # Lists Node.js dependencies and project scripts
170+
β”‚ └── vite.config.js # Configuration file for the Vite build tool
171+
β”‚
172+
└── README.md # You are here!
173+
```
174+
175+
176+
# AI Health Chatbot
177+
178+
Medibot is a Streamlit-based AI health assistant that provides symptom checking, health guidance, and doctor recommendations using NLP and Retrieval-Augmented Generation (RAG).
179+
180+
---
181+
182+
## πŸš€ New Feature: NLP Enhancement (Multilingual Support)
183+
184+
- Added translation pipeline (English ↔ Hindi, Marathi, Telugu).
185+
- Integrated multilingual embeddings with FAISS.
186+
- Added language selector in Streamlit UI.
187+
- Ensured responses maintain medical safety disclaimer.
188+
189+
### How to Run:
190+
1. `pip install -r requirements.txt`
191+
2. `streamlit run app/WellnessResourceHub.py`
192+
136193
```
137194
AI-health-chatbot/
138195
β”œβ”€β”€ πŸ“ backend/ # Backend API and services
@@ -275,6 +332,7 @@ cd backend
275332
docker-compose up # No --build flag needed unless dependencies change
276333
```
277334

335+
278336
**Frontend**:
279337
```
280338
cd client
@@ -309,8 +367,15 @@ The application uses Pydantic for configuration management. Key settings include
309367

310368
## πŸ§ͺ Testing the System
311369

370+
371+
```env
372+
GROQ_API_KEY="YOUR_KEY_HERE"
373+
HUGGINGFACE_API_KEY="YOUR_KEY_HERE"
374+
```
375+
312376
### πŸ” **Basic Functionality Test**
313377

378+
314379
1. **Start the Application** (both backend and frontend)
315380

316381
2. **Navigate to the Symptom Checker** in your browser
@@ -515,6 +580,10 @@ The MIT License allows for:
515580
516581
## πŸ‘₯ Contributors
517582
583+
584+
585+
->Thank you once again to all our contributors who has contributed to **AI-health-chatbot!** Your efforts are truly appreciated. πŸ’–πŸ‘
586+
518587
### πŸ§‘β€πŸ’Ό **Project Admin**
519588
<table>
520589
<tr>
@@ -530,6 +599,7 @@ The MIT License allows for:
530599
</tr>
531600
</table>
532601
602+
533603
### πŸ‘¨β€πŸ« **Mentors (GSSoC '25)**
534604
<table>
535605
<tr>
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.

0 commit comments

Comments
Β (0)