superpython-agent 0.0.1

LLM assistant for Python packages in REPLs and notebooks

LLM-powered assistant for every Python package you import.
Just add .superpython.ask("your question") to any module.

---

🧠 SuperPython Agent

SuperPython Agent automatically injects a .superpython assistant into every package you import. Ask questions about the library you're using, get help with errors, and explore code with syntax-highlighted answers — all powered by an LLM.

---

🎥 Demo

(Click to view full video)

https://github.com/superpandas-ai/superpython/assets/demo.gif
or
https://loom.com/share/superpython-demo-link

---

❓ Why SuperPython?

There are thousands of Python libraries, but their docs aren't always intuitive. SuperPython fills that gap:

• You don't need to search Stack Overflow every time you forget a method.
• You get context-aware help, including recent exceptions and object summaries.
• It's built for exploration — whether you're using a notebook, REPL, or script.

---

✨ Features

• 💬 Ask any module .superpython.ask("How do I do X?")
• 💡 Smart context: recent errors + object summaries
• 🧩 Auto-attaches to every import
• 💾 Caches answers to avoid repeated API calls
• 🎨 Syntax-highlighted output with pygments
• 🧠 IPython magic: %super pandas how to merge?

---

🚀 Getting Started

1. Install

pip install superpython

2. Import It

import superpython

It hooks into all future imports.

🧪 Usage Examples

Inline Python

import matplotlib

matplotlib.superpython.ask("how to make a scatter plot?")

In Jupyter / IPython

%load_ext superpython

%super numpy how to generate random numbers?

Programmatic

from superpython import agent

agent.ask("requests", "how do I send a POST request?")

🔧 Requirements

• openai
• ipywidgets
• pygments
• ipython

(Installed automatically.)

🧠 Project Structure

superpython_agent/
├── superpython/
│   ├── agent.py
│   ├── cache.py
│   ├── context.py
│   ├── import_hook.py
│   ├── ipython_magics.py
│   ├── widgets.py
│   └── __init__.py
├── setup.py
├── pyproject.toml
└── README.md

🤝 Contributing

SuperPython is early-stage — PRs and ideas welcome!

• Want to support other LLMs?
• Want advanced caching or error tracing?
• Want to auto-annotate cells with answers?

Open an issue or submit a PR. 💥

🧷 License

MIT © 2025 SuperPandas Ltd