Skip to main content

AI-powered chat agent about Vishnu Suresh Perumbavoor. Powered by Qwen2.5-0.5B.

Project description

🤖 VSP Agent

PyPI version Python Versions License: MIT

AI-powered chat agent about Vishnu Suresh Perumbavoor. Powered by Qwen2.5-0.5B.

🚀 Features

  • 🧠 AI Chat: Interactive conversations powered by Qwen2.5-0.5B language model
  • 💬 Natural Language: Ask anything about VSP in plain English
  • 🧠 Conversation Memory: Maintains context throughout the chat session
  • GPU Acceleration: Automatic GPU support for 30-50x faster responses
  • 🎯 CLI Interface: Easy-to-use command-line interface
  • 🐍 Python API: Programmatic access for developers

📦 Installation

pip install vspagent

🎯 Quick Start

CLI Mode

Simply run:

vspagent-py

This launches an interactive chat session with the VSP Agent!

Example Chat Session:

💬 You: Who is VSP?
🤖 VSP Agent: VSP stands for Vishnu Suresh Perumbavoor. He is the founder 
of VSP Enterprises and VSP Intelligence. He's a Software Engineer, Singer, 
and YouTuber...

💬 You: What technologies does he use?
🤖 VSP Agent: He works with React, Node.js, FastAPI, Docker, MongoDB...

💬 You: What has he accomplished?
🤖 VSP Agent: He won 3rd prize in Vaiga Agrihack 2023...

💬 You: exit
👋 Thanks for chatting!

Features:

  • 🤖 AI-powered conversations with Qwen2.5-0.5B
  • 💬 Natural language understanding
  • 🧠 Conversation memory (maintains context)
  • ⚡ GPU acceleration (30-50x faster if available)
  • 🎯 Simple and focused on chatting about VSP

Note: Command is vspagent-py (not vspagent) to avoid conflicts with the JavaScript version.

Python API

from vspagent import VSPAgent, biodata

# Create agent instance
agent = VSPAgent()

# Initialize AI model (loads Qwen2.5-0.5B)
agent.init_ai()

# Chat with the agent
response = agent.chat("Who is VSP?")
print(response)

# Continue conversation with context
conversation_history = []
conversation_history.append({"role": "user", "content": "Who is VSP?"})
conversation_history.append({"role": "assistant", "content": response})

response2 = agent.chat("What technologies does he use?", conversation_history)
print(response2)

# Access biodata directly
print(biodata['creator'])
print(biodata['technologies'])

📚 API Reference

VSPAgent Class

Methods

  • init_ai(): Initialize the Qwen2.5-0.5B AI model (required before chatting)
  • chat(message, conversation_history=None): Chat with the AI agent
    • message (str): Your question or message
    • conversation_history (list, optional): Previous conversation for context
    • Returns: AI-generated response as string

biodata Dictionary

Contains comprehensive information about Vishnu Suresh Perumbavoor:

  • Personal information
  • Founder companies
  • Technologies and skills
  • Accomplishments
  • Social media links

🛠️ Requirements

  • Python 3.8+
  • transformers >= 4.30.0
  • torch >= 2.0.0

🎨 Using the CLI

When running vspagent-py:

  • Simply type your questions or messages
  • The AI will respond with information about VSP
  • Type exit or quit to end the conversation
  • Conversation context is maintained throughout the session

👨‍💻 About VSP

Vishnu Suresh Perumbavoor is the founder of VSP Enterprises and VSP Intelligence. He's a:

  • Software Engineer
  • Singer
  • YouTuber
  • Technology enthusiast

🏆 Accomplishments

  • Won 3rd prize in Vaiga Agrihack 2023
  • Participated in Rajasthan IT Hackathon 2023
  • Won 1st prize in startup idea presentation at Palakkad

🔧 Technologies

React, Node.js, FastAPI, Express, MongoDB, Docker, OHIF, Cornerstone3D, VTKjs, DICOM

🔗 Connect

📄 License

MIT License - see LICENSE file for details

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

🐛 Issues

Found a bug? Report it here

📈 Version

Current version: 2.2.0


Made with ❤️ by Vishnu Suresh Perumbavoor

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vspagent-2.2.0.tar.gz (9.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

vspagent-2.2.0-py3-none-any.whl (8.3 kB view details)

Uploaded Python 3

File details

Details for the file vspagent-2.2.0.tar.gz.

File metadata

  • Download URL: vspagent-2.2.0.tar.gz
  • Upload date:
  • Size: 9.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.9

File hashes

Hashes for vspagent-2.2.0.tar.gz
Algorithm Hash digest
SHA256 f2c31385dc199119aadaeb892b290048e4cdaea956922d3ecf57540ee9a51fc8
MD5 9f8cee27e8ee7bfdf5d072324f728ee6
BLAKE2b-256 dc9a3a7a8c74e8386ca1da8fce4ed7fee7dca47cff81aca4c9bb278f0300636b

See more details on using hashes here.

File details

Details for the file vspagent-2.2.0-py3-none-any.whl.

File metadata

  • Download URL: vspagent-2.2.0-py3-none-any.whl
  • Upload date:
  • Size: 8.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.9

File hashes

Hashes for vspagent-2.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 023d476e37a2079caf11330c6016e6c3ed6831a295fb5548b42510a68960186e
MD5 01a408e2e7445057592f7efb03adee5a
BLAKE2b-256 3b2e5806a75401a27d2d23b5c81d1e36b77b8e3b1da788300289d3d5d58f6044

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page