GPT Fusion

A Python toolkit for building AI-assisted applications: text processing, web scraping, a FastAPI backend, and the interactive demos below.

pip install gpt-fusion Try Interactive Demos View on GitHub

🚀 Quick Start

📦 Quick Install

Core text, math & CSV utilities

pip install gpt-fusion

✓ Text processing
✓ CSV data analysis
✓ Project generators

🎯 Full Install

Everything, including optional extras

pip install "gpt-fusion[web,twitter,backend,build]"

✓ Web scraping (BeautifulSoup)
✓ FastAPI backend server
✓ Twitter integration

✨ Features

Every feature this package ships, showcased once - the first three run live in your browser, no install required.

🔤 Text Processing

Smart text utilities with instant results

Enter text to process:

Output:

Click a button to see the magic! ✨

Python Code:

import gpt_fusion

# Try the functions above!
text = "Your input here"
gpt_fusion.word_count(text)
gpt_fusion.reverse_words(text)
gpt_fusion.is_palindrome(text)

📊 CSV Data Analysis

Powerful data processing with streaming support

Enter CSV data (comma-separated values):

Analysis Results:

Enter CSV data to see analysis! 📈

Python Code:

import gpt_fusion

# Load data from CSV file
data = gpt_fusion.load_numbers_from_csv('data.csv')

# Fast streaming for large files
avg = gpt_fusion.average_from_csv('data.csv', use_streaming=True)
med = gpt_fusion.median_from_csv('data.csv')

print(f"Average: {avg}")
print(f"Median: {med}")

🛠️ Project Generator

Generate production-ready projects instantly

Generated Command:

Click a project type above to see the generation command! 🎯

🌐

Web Scraping

Simple scraping utilities with BeautifulSoup, blocked from hitting private/internal addresses. Install: pip install "gpt-fusion[web]"

gpt_fusion.scrape("https://example.com", "p")
# ['This domain is for use in documentation
#   examples without needing permission. Avoid
#   use in operations.', 'Learn more']

🚀

FastAPI Backend

Ready-to-deploy API server with auto-generated docs. Install: pip install "gpt-fusion[backend]"

GET /greet/Alice

{"message": "Hello, Alice! Welcome
  to gpt-fusion."}

🐦

Twitter Integration

Twitter bot utilities with OAuth support, reading credentials straight from the environment. Install: pip install "gpt-fusion[twitter]"

bot.post_tweet("x" * 300)
# ValueError: Tweet exceeds 280 characters

🔐

Auth UI Kit

Tailwind CSS login form with Firebase auth: email/password and Google OAuth flows.

✓ Accessible modal focus management

✓ Field-level validation & error messages

✓ Hardened CSP, no inline scripts

Try it Live Source

🎯

Unity 3D Demo

C# gameplay systems (movement, items, achievements). Script-only reference - no packaged scenes to play yet, so here's the real object-pooling code instead of a screenshot:

Queue<GameObject> queue = _poolDictionary[tag];
if (queue.Count == 0)
{
    // Every object for this tag is still active/in-flight.
    // Fail loudly instead of corrupting an active object.
    Debug.LogWarning($"Pool '{tag}' exhausted - all objects in use.");
    return null;
}

GameObject objectToSpawn = queue.Dequeue();
objectToSpawn.SetActive(true);
objectToSpawn.transform.position = position;

View All Scripts

🔌 API & Deployment

Local Development

pip install "gpt-fusion[backend]"
uvicorn gpt_fusion.backend:app --reload

Visit http://localhost:8000/docs for interactive Swagger UI documentation.

Available Endpoints

Method	Endpoint	Description
GET	/	Welcome message
GET	/greet/{name}	Personalized greeting
GET	/projects	List of demo projects
GET	/health	Health check endpoint

Deploy to Render

Create a new Web Service from your GitHub repo
Build Command: pip install "gpt-fusion[backend]"
Start Command: uvicorn gpt_fusion.backend:app --host 0.0.0.0 --port $PORT

Deploy to Heroku

Create a Procfile:

web: uvicorn gpt_fusion.backend:app --host 0.0.0.0 --port $PORT

🤝 Contributing

Development Setup

git clone https://github.com/costasford/gpt-fusion.git
cd gpt-fusion
pip install -r requirements-dev.txt
pip install -e .

Run Tests

pytest --cov=src/gpt_fusion --cov-report=term-missing

Code Quality

python scripts/run_checks.py

This runs:

Black - Code formatting
Flake8 - Linting
Pytest - Test suite with 93% coverage

Project Structure

src/gpt_fusion/     # Main package
├── core.py         # Basic utilities
├── text_utils.py   # Text processing
├── analysis.py     # CSV/data tools
├── web_scraper.py  # Web scraping (optional)
├── backend.py      # FastAPI server (optional)
├── twitter_bot.py  # Twitter integration (optional)
└── starter_kits.py # Project templates

tests/              # Comprehensive test suite
docs/               # Jekyll documentation
examples/           # Usage examples

Links

📖 GitHub Repository • 🐛 Report Issues • 📄 MIT License