HitmanHints G-Assist Plugin

Get spoiler-free, AI-powered hints for Hitman missions via voice or text commands - right from your NVIDIA G-Assist overlay!

This plugin is based off web app version of the HitmanHints project.

🎯 What It Does

HitmanHints provides intelligent, context-aware hints for 1,000+ Hitman mission walkthroughs without spoiling the experience. Ask questions in natural language and get just enough guidance to progress without ruining the discovery.

Example Commands

"Hey Hitman, I need help with Mumbai Memoirs"
"Hitman, I'm stuck at the market in Mumbai, what should I do?"
"Hey Hitman, how do I start the Paris Showstopper mission?"
"Hitman, list available missions"

✨ Features

• 1,000+ Mission Transcripts: Covers all major Hitman games and challenges
• Spoiler-Free Hints: AI reveals ONE step at a time with just enough detail
• Voice Commands: Use G-Assist's built-in voice recognition
• Fuzzy Matching: Don't need exact mission names - keywords work great
• Persistent State: Remembers your current mission across multiple questions

📦 Installation

Prerequisites

• NVIDIA GeForce RTX GPU (30 Series or newer for voice commands)
• NVIDIA App with G-Assist enabled
• Python 3.9+
• OpenAI API Key

Setup Steps

1. Copy Plugin to G-Assist Directory

# Navigate to G-Assist plugins directory
cd "C:\Users\YourUsername\AppData\Local\NVIDIA\G-Assist\plugins"

# Create hitmanhints directory
mkdir hitmanhints
cd hitmanhints

# Copy plugin files
# - Copy all files from g_assist_plugin/ folder
# - Copy transcripts/ folder to parent directory

2. Install Dependencies

pip install -r requirements.txt

3. Configure API Key

# Copy config template
cp config.json.template config.json

# Edit config.json and add your OpenAI API key
{
  "openai_api_key": "sk-your-key-here",
  "transcripts_dir": "../transcripts"
}

4. Create Executable (Required for G-Assist)

# Install PyInstaller
pip install pyinstaller

# Create executable
pyinstaller --onefile --name g-assist-plugin-hitmanhints plugin.py

# Move executable to plugin directory
move dist/g-assist-plugin-hitmanhints.exe ./

5. Restart G-Assist

Press Alt+G to close and reopen G-Assist to load the plugin.

🎮 Usage

Direct Plugin Invocation

Tell G-Assist explicitly to use Hitman hints:

"Hey Hitman, I need help with Dubai Silent Assassin"
"Hitman, where can I find a disguise in Paris?"

Zero-Shot Function Calling

Let G-Assist automatically detect your need for Hitman hints:

"/fc I'm stuck on the Mumbai Memoirs mission"
"/fc How do I get into the mansion in Paris Showstopper?"

Available Commands

Command	Example	What It Does
combined_hint	"Hey Hitman, help with Mumbai Memoirs, I'm at the beach"	Load mission and get hint in one step
load_mission	"Hitman, load Paris Showstopper"	Load a specific mission
get_hint	"Hitman, where do I go next?"	Get hint for current mission
list_missions	"Hitman, what missions are available?"	List available missions
reset_mission	"Hitman, start a new mission"	Clear current mission

🔧 Plugin Architecture

hitmanhints/
├── g-assist-plugin-hitmanhints.exe  # Compiled plugin executable
├── manifest.json                     # Plugin configuration for G-Assist
├── config.json                       # Your API key and settings
├── plugin.py                         # Main plugin interface
├── hitman_core.py                   # Core bot logic
├── requirements.txt                  # Python dependencies
└── README.md                        # This file

../transcripts/                       # Mission transcript files (1,034 files)

💡 How It Works

1. User asks question via voice or text in G-Assist overlay
2. G-Assist calls plugin with mission name and question
3. Plugin loads transcript using fuzzy matching
4. AI chunks transcript into logical gameplay steps (GPT-4.1-nano)
5. AI generates hint revealing ONE step at a time (GPT-4.1-mini)
6. Hint appears in G-Assist without leaving your game!

AI Configuration

• Chunking: gpt-4.1-nano-2025-04-14 @ temperature 0.3
• Hints: gpt-4.1-mini-2025-04-14 @ temperature 0.8
• Philosophy: Reveal ONE step at a time with specific details, but never multiple steps

🐛 Troubleshooting

Plugin Not Showing Up

1. Make sure the directory is named hitmanhints (lowercase)
2. Check that g-assist-plugin-hitmanhints.exe exists in the directory
3. Verify manifest.json is valid JSON
4. Restart G-Assist (Alt+G twice)

"No Mission Loaded" Error

The plugin needs to load a mission before giving hints:

"Hey Hitman, load Mumbai Memoirs"

Then ask your question:

"Where should I go first?"

Or use combined_hint:

"Hey Hitman, help with Mumbai Memoirs, where should I go first?"

API Key Errors

1. Make sure config.json exists (copy from config.json.template)
2. Verify your OpenAI API key is correct
3. Check you have credits in your OpenAI account
4. Ensure key has access to GPT-4 models

Slow Responses

• First hint takes 10-20 seconds (transcript analysis)
• Subsequent hints for same mission are faster (~2-3 seconds)
• Running on RTX GPU with G-Assist may briefly impact game FPS

📊 API Costs

Approximate costs per mission (OpenAI pricing):

• First question (with transcript chunking): ~$0.01-0.03
• Follow-up questions: ~$0.001-0.003

A typical mission with 3-4 hints costs ~$0.02-0.05 total.

🤝 Contributing

This plugin is part of the HitmanHints project.

To contribute:

1. Fork the repository
2. Make your changes
3. Test with G-Assist
4. Submit a pull request

📄 License

Apache License 2.0 - See LICENSE file for details

🙏 Credits

• AI Models: OpenAI GPT-4.1-nano & GPT-4.1-mini
• Platform: NVIDIA Project G-Assist
• Transcripts: Community walkthrough contributions
• Framework: Gradio (original web interface)

📞 Support

• Issues: Report on GitHub
• G-Assist Docs: https://github.com/NVIDIA/G-Assist

---

Enjoy spoiler-free Hitman gameplay! 🎯🔫