Skip to content

Releases: ReZaiden/SalesFlow-AI-with-Python

Initial Stable Release(SalesFlow AI with python)

16 Nov 16:39
@ReZaiden ReZaiden
v1.0.0
f5da716

Choose a tag to compare

View all tags
Initial Stable Release(SalesFlow AI with python) Latest
Latest

🤖 AI Sales Agent with Lead Generation

Live Demo Click Here👆🏻

Python
OpenAI
Gradio
ntfy.sh
Pandas
PyPDF

A conversational AI sales agent capable of interacting with users,
filtering products from Excel/PDF/TXT, capturing leads, and sending
real-time notifications using ntfy.sh.
Powered by OpenAI, Gradio, and a fully modular architecture.

⚠️ Note: This project is built for development and testing.
For production, ensure secure API keys, HTTPS, and proper rate
limiting.

🚀 Features

  • 💬 Natural AI chat using OpenAI function-calling\
  • 🔍 Product filtering by name, min/max price\
  • 📥 Lead capturing (email & phone)\
  • 🚨 Instant notifications via ntfy.sh\
  • 📚 Knowledge Base from Excel, PDF, and TXT\
  • 🎨 Beautiful Gradio UI with custom themes\
  • 📝 Centralized logging (file + console)\
  • 🧪 Full test coverage with pytest

🧠 Tech Stack

Technology Version Description

Python 3.9+ Core language
OpenAI API Latest LLM & tool calling
Gradio 4.0+ Interactive UI
ntfy.sh API Real-time alerts
Pandas 2.0+ Excel loader
PyPDF Latest PDF parser
PyYAML Latest Config management
python-dotenv Latest Environment variables

⚙️ Prerequisites

Before running the project, ensure you have:

  • 🐍 Python 3.9+\
  • 📦 pip\
  • 🌐 Git\
  • 🔔 ntfy.sh topic (free)\
  • 🔑 AI API key like OpenAI

🛠️ Installation

git clone https://github.com/yourusername/SalesFlow-AI.git
cd SalesFlow-AI
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

🗝️ Edit .env file

  1. Rename .env.sample file to .env
  2. Put your environment variables to it(like AI_API_KEY)

📃 Run Tests

python -m pytest

▶️ Run the Project

python -m app

and then go to http://localhost:8000/

📡 How It Works

  1. User starts the chat → Agent greets as AidenAI\
  2. Smart questions detect customer needs\
  3. Product filtering using filter_products tool\
  4. Results explained naturally\
  5. Lead capture (email/phone)\
  6. Real‑time ntfy.sh alert\
  7. Logging saved in logs/*.log

🧩 Project Structure

files/
├── info.pdf
├── products.xlsx
└── summary.txt
logs/
└── *.log
src/
├── agent.py
├── tools.py
├── data.py
├── config.py
├── logger.py
└── ui.py
app.py
config.yaml

🔒 Security Notes

  • Keep API keys inside .env\
  • Change values in config.yaml

💡 Future Improvements

  • Vector search with ChromaDB\
  • Database chat history\
  • Lead analytics dashboard

🧑‍💻 Author

Developed by: ReZaiden
💼 GitHub: @ReZaiden
📧 Contact: rezaidensalmani@gmail.com

Assets 2
Loading