Skip to content

gsoni1/HitmanHints

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

HitmanHints

Spoiler-Free, AI-Powered Hints for Hitman Missions for completing Hitman missions & challenges, without ruining the fun!

HitmanHints is an AI assistant that gives spoiler-free, step-by-step gameplay hints for 1,000+ Hitman missions and challenges. It preserves the fun and discovery of solving each mission while giving players just enough guidance to progress.

Available NOW at HitmanHints as a Web App, Desktop App, and NVIDIA G-Assist Plugin!

hitmanwoa

✨ Features

🔍 Smart Mission Detection

Type any keywords (“mumbai memoirs”, “paris suit only”, “bank vault”) and the system will fuzzy-match the right walkthrough.

🧠 Automatic Transcript Processing

Powered by OpenAI GPT-4.1-nano and GPT-4.1-mini, HitmanHints automatically analyzes walkthrough transcripts, breaks them into logical steps, and then reveals hints only when and where you need them.

💡 One-Step-at-a-Time Hints

Ask for help and get one actionable, non-spoiling hint based on where you are in the mission.

💬 Conversational Assistant

Talk naturally — the hint system tracks context and only reveals the next step when asked.

Demo

hitmanhintsdemo.mov

Product Spec

See the Google Doc

🚀 Quick Start

Step 1 - Head to HitmanHints

Step 2 — Pick a Mission

Just type a keyword like

  • "mumbai memoirs"
  • "paris"
  • "silent assassin"
  • "bank mission"

The system fuzzy-matches the right transcript.

Step 3 — Ask for Hints

Examples:

  • “How do I start?”
  • “Where can I find a good disguise?”
  • “I’m stuck near the beach, what should I do next?”

💡 Tips for Best Results

  • Describe where you’re stuck
  • Give location or disguise if possible
  • Be specific for stronger hints
  • Ask follow-ups to progress step-by-step

Step 4 — Get More Hints

Each hint only reveals one step. Ask follow-ups to keep progressing without spoilers.

Reset -

Type /new to switch missions anytime.

🧠 How the AI Works

  • Automatically breaks down walkthroughs into logical gameplay steps
  • Filters out commentary and focuses on actionable guidance
  • Uses optimized GPT-4.1 models for consistent, quality hints

For more information, see the Technical Summary

🧩 G-Assist Integration (Related)

HitmanHints was designed to be an assistant that players can use while in game. This is similar to the goal of NVIDIA’s G-Assist technology, which aims to use a local LLM or external api to provide the player with help such as improving system performance, but also the player can ask questions about the game and receive answers.

Therefore, I adapted HitmanHints to also work as an NVIDIA G-Assist plugin, similar to how NVIDIA’s in-game AI assistant works. G-Assist provides voice-driven, context-aware help inside PC games, and HitmanHints can act as a specialized plugin that offers spoiler-free Hitman mission assistance directly in-game.
See this repo, also by me for more details on the G-Assist Plugin version of HitmanHints: HitmanHints G-Assist

Ideally, a future iteration would be built into an overlay, such as NVIDIA’s G-Assist. And rather than unofficially using transcript solutions, the developers would provide NVIDIA with the information about solving all the challenges in a document, which could be used with an LLM to provide context so that the LLM can provide accurate information to the player’s questions (essentially RAG).

Similarly, other games could have custom agents built into NVIDIA G-Assist that are trained on game specific information provided by the devs, and G-Assist would detect compatible games and provide the best AI assistance, built right into the player’s PC, for free (since the agent could run locally).

For more information about Nvidia G-Assist, see:

🎬 Acknowledgements and Sources

All transcripts sourced from MrFreeze2244's comprehensive Hitman walkthrough series:

Huge thanks to MrFreeze2244 for creating detailed Hitman walkthroughs that make this project possible!

If you enjoy the tool, consider starring the repo ⭐

About

An AI assistant, that gives spoiler-free, step-by-step hints for 1,000+ missions, challenges, and escalations in Hitman.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages