HyBio-Agent / README.md
XMMR12's picture
Update
9ceda7c verified
---
title: HyBio Agent πŸŒΏπŸ’Š
emoji: 🌿
colorFrom: pink
colorTo: pink
sdk: gradio
sdk_version: 5.33.0
app_file: app.py
pinned: true
license: apache-2.0
short_description: Agent that helps you with natural treatment
tags:
- agents
- web-search
- plants
- medical
thumbnail: >-
https://huggingface.co/spaces/XMMR12/HyBio-Agent/resolve/main/thumbnail.png
---
# 🌿 HyBio Agent - Natural Treatment Assistant
HyBio Agent is an AI-powered botanist assistant that analyzes health symptoms and provides evidence-based natural treatment recommendations using medicinal plants. This interactive tool combines traditional botanical knowledge with modern AI to deliver personalized plant-based remedies.
## Features
- **Symptom Analysis**: Understands natural language descriptions of health conditions
- **Plant-Based Recommendations**: Suggests medicinal plants with therapeutic properties
- **Treatment Plans**: Provides dosage instructions and application methods
- **Comprehensive Database**: Matches symptoms to scientifically-backed plant remedies
- **User-Friendly Interface**: Simple chat-based interaction with example prompts
## How It Works
```mermaid
graph TD
A[User Input] --> B(Symptom Analysis)
B --> C{Symptom Detection}
C -->|Symptoms Found| D[Plant Database Lookup]
C -->|No Symptoms| E[General Botanist Advice]
D --> F[Treatment Plan Generation]
F --> G[Personalized Recommendations]
G --> H[Output to User]
```
## Usage Guide
### How to Use
- **Describe your symptoms** in natural language
*(e.g., "I have a headache and nausea")*
- **Receive AI-analyzed** plant-based treatment recommendations
- **Explore** dosage instructions and application methods
- **Ask follow-up questions** about specific plants or treatments
### Try These Examples:
> - "What helps with anxiety and insomnia?"
> - "Natural remedies for skin burns"
> - "Plant-based solutions for digestive issues"
---
## Video
[![HyBio App Screenshot](https://huggingface.co/spaces/Agents-MCP-Hackathon/HyBio-Agent/resolve/f107f09315404590608a4debed83e8285c9c6ab1/image.png)](https://drive.google.com/file/d/1qL4mAaK86D0NDyNKL62RMOVqLHQwqjsV/view?usp=drivesdk)
## Technical Requirements
### Prerequisites
- Python 3.8+
- Package Requirements:
```python
gradio == 5.33.0
requests
smolagents
```
### Installation
```python
git clone https://huggingface.co/spaces/Agents-MCP-Hackathon/hybio-agent.git
cd hybio-agent
pip install -r requirements.txt
```
###Configuration
Set your API endpoint in app.py:
`API_ENDPOINT = "your_assistant_api_endpoint_here" #(with its fullpath to the model , should work in post and get requests)`
#### Customize the system message for different bot behaviors:
`system_message = "You are an expert ethnobotanist specializing in Amazonian medicinal plants"`
Running the Application
`python app.py`
Access the interface at `http://localhost:7860`
### Deployment to Hugging Face Spaces
- Create a new Space with Gradio SDK
- Add your API endpoint as a secret in Space settings
- Push your repository to the Space
**Disclaimer**
*Recommendations provided by HyBio Agent are for informational purposes only. Plant-based treatments can interact with medications and health conditions. Always consult with a qualified healthcare professional before using any herbal remedy, especially if pregnant, nursing, or undergoing medical treatment. Do not use as a substitute for professional medical advice.*
---
Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference