base on Universal Second Eye for Gamers with Impairments (Universal AI Aim Aligner - ONNX/YOLOv8 - C#) > [!NOTE] > If you enjoy Aimmy, please consider giving us a star ⭐! We appreciate it! :) <p> <a href="https://aimmy.dev/" target="_blank"> <img width="100%" src="readme_assets/AimmyV2Banner.png"></a> </p> Aimmy is a universal AI-Based Aim Alignment Mechanism developed by BabyHamsta, MarsQQ & Taylor to make gaming more accessible for users who have difficulty aiming. Unlike most AI-Based Aim Alignment Mechanisms, Aimmy utilizes DirectML, ONNX, and YOLOV8 to detect players, offering both higher accuracy and faster performance compared to other Aim Aligners, especially on AMD GPUs, which would not perform well on Aim Alignment Mechanisms that utilize TensorRT. Aimmy also provides an easy to use user-interface, a wide set of features and customizability options which makes Aimmy a great option for anyone who wants to use and tailor an Aim Alignment Mechanism for a specific game without having to code. Aimmy is 100% free to use. This means no ads, no key system, and no paywalled features. Aimmy is not, and will never be for sale for the end user, and is considered a source-available product, **not open source** as we actively discourage other developers from making commercial forks of Aimmy. Please do not confuse Aimmy as an open-source project, we are not, and we have never been one. Want to connect with us? Join our Discord Server: https://discord.gg/aimmy If you want to share Aimmy with your friends, our website is: https://aimmy.dev/ ## Table of Contents - [What is the purpose of Aimmy?](#what-is-the-purpose-of-aimmy) - [How does Aimmy Work?](#how-does-aimmy-work) - [Features](#features) - [Setup](#setup) - [How is Aimmy better than similar AI-Based tools?](#how-is-aimmy-better-than-similar-ai-based-tools) - [How the hell is Aimmy free?](#how-the-hell-is-aimmy-free) - [How do I train my own model?](#how-do-i-train-my-own-model) - [How do I upload my model to the "Downloadable Models" menu](ModelUpload.md) ## What is the purpose of Aimmy? ### Aimmy was designed for Gamers who are at a severe disadvantage over normal gamers. ### This includes but is not limited to: - Gamers who are physically challenged - Gamers who are mentally challenged - Gamers who suffer from untreated/untreatable visual impairments - Gamers who do not have access to a seperate Human-Interface Device (HID) for controlling the pointer - Gamers trying to improve their reaction time - Gamers with poor Hand/Eye coordination - Gamers who perform poorly in FPS games - Gamers who play for long periods in hot environments, causing greasy hands that make aiming difficult ## How does Aimmy Work? ```mermaid flowchart LR A["Playing Game System"] C["Screen Grabbing Functionality"] B["YOLOv8 (DirectML + ONNX) Recognition"] D{Making Decision} DA["X+Y Adjustment"] DB["FOV"] E["Triggering Functionality"] F["Mouse Cursor"] A --> E--> C --> B --> D --> F DA --> D DB --> D ``` When you press the trigger binding, Aimmy will capture the screen and run the image through AI recognition powered by your computer hardware. The result it develops will be combined with any adjustment you made in the X and Y axis, and your current FOV and will result in a change in your mouse cursor position. ## Features 1. Full Fledged UI - Aimmy provides a well designed and full-fledged UI for easy usage and game adjustment. 2. DirectML + ONNX + YOLOv8 AI Detection Algorithm - The use of these technologies allows Aimmy to be one of the most accurate and fastest Aim Alignment Mechanisms out there in the world 3. Dynamic Customizability System - Aimmy provides an interactive customizability system with various features that auto-updates the way Aimmy will aim as you customize. From AI Confidence, to FOV, to Anti-Recoil Adjustment, Aimmy makes it easy for anyone to tune their aim 4. Dynamic Visual System - Aimmy contains a universal ESP system that will highlight the player detected by the AI. This is helpful for visually impaired users who have a hard time differentiating enemies, and for configuration creators attempting to debug their configurations. 5. Adjustable Anti-Recoil - Aimmy offers an incredibly customizable Anti-Recoil system that's designed to be easy to use. With features like recording your Fire Rate, setting your X and Y adjustment, and Configuration Switch Keybindings 6. Mouse Movement Method - Aimmy grants you the right to switch between 5 Mouse Movement Methods depending on your Mouse Type and Game for better Aim Alignment 7. Hotswappability - Aimmy lets you hotswap models and configurations on the go. There is no need to reset Aimmy to make your changes 8. Model and Configuration Store with Repository Support - Aimmy makes it easy to get any models and configurations you may ever need, and with repository support, you can get up to date with the latest models and configurations from your favorite creators ## Setup - Download and Install the x64 version of [.NET Runtime 8.0.X.X](https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-desktop-8.0.2-windows-x64-installer) - Download and Install the x64 version of [Visual C++ Redistributable](https://aka.ms/vs/17/release/vc_redist.x64.exe) - Download Aimmy from [Releases](releases) (Make sure it's the Aimmy zip and not Source zip) - Extract the Aimmy.zip file - Run Aimmy.exe - Choose your Model and Enjoy :) ## How is Aimmy better than similar AI-Based tools? Aimmy is written in C# using .NET 8 and WPF utilizing pre-existing libraries like DirectML and ONNX. This has allowed us to make a very fast Aim Aligner with high compatiblity on both AMD and NVIDIA GPUs without sacrificing the end-user experience.  Beyond the core functionality, Aimmy also adds some amazing additional features like Detection ESP and Anti-Recoil to help you tune your gaming experience however you like it. Aimmy comes pre-bundled with 2 well trained AI models with thousands of images each. 1. Phantom Forces 2. Universal Model Besides those 2 models, Aimmy provides dozens of other community made models through the store, with more models being developed every day by other Aimmy users. These models vary from game to image count, making Aimmy incredibly versatile and universal for thousands of games on the market right now. ## How the hell is Aimmy free? As an AI based Aim Aligner, Aimmy does not require any sort of upkeep because it does not read any specific game data to perform it's actions. If Aimmy team stops maintaining Aimmy, even if no one pitches in to fork and maintain the project, Aimmy would still work. This has meant that while we do currently use out of pocket expenses to run Aimmy, those expenses have been low enough that it hasn't been a necessity for Aimmy to run on even an ad-supported model. We do not seek to make money from Aimmy, we only seek your kind words <3, and a chance to help people aim better, by assisting their aim or even to train how they aim (yes, you can use Aimmy in that way too) ## How do I train my own model Please see the video tutorial below on how to label images and train your own model. (Redirects to Youtube) [](https://youtu.be/i98wF4218-Q) ## How do I upload my model to the "Downloadable Models" menu? Please read the tutorial at [UploadModel.md](ModelUpload.md) ", Assign "at most 3 tags" to the expected json: {"id":"4304","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"