NPC-Forge

NPC-Forge is a framework for building conversational agents with distinct personalities, multi-turn context, sentiment analysis, and tool-call support. NPCs run on the CPU (web browser or OS) even on embedded systems and obsolete hardware without relying on machine learning or LLMs.

Instead of praying for a model to do the right thing, you can now use NPC-Forge to quickly build a deterministic agent and hook it up to your favourite workflow, API or harness.

Why NPC-Forge?

Many problems you encounter can be solved without machine-learning or LLMs. NPC-Forge gives you a way to solve those problems more efficiently:

• Deterministic: can't hallucinate or generate slop; has no safety alignment filters.
• Fast: runs on the CPU and responds in milliseconds.
• Reliable: tolerates typos, expletives, interjections and word inversions much better than NLP.js
• Extensible: datasets can be developed with ease thanks to NDF 0.0 (NPC-Forge Dataset Format).
• No training: update the dataset, execute npc-forge reboot, and you are done.
• Plug-and-play: implements an OpenAI-compatible API that connects your NPCs to your preferred LLM harness in seconds. Connect the NPC-Forge API endpoint to tools like Open WebUI or Copilot, and see your NPCs responding and executing tool calls at lightspeed.

NPC-Forge CLI

Administer, install, and run your NPCs with the following terminal commands:

npc-forge list           # Lists the installed NPCs
npc-forge test           # Run NPC-Forge test suite
npc-forge serve          # Starts OpenAi/Copilot compatible API server
npc-forge stop           # Stops server
npc-forge reboot         # Reboots server
npc-forge watch          # Starts server and watch logs in real-time
npc-forge install <path> # Installs a new NPC

Additional information can be found in the NPC-Forge CLI documentation.

TERMy terminal assistant

TERMy is the first NPC baked into the NPC-Forge framework. It is a cynical but very knowledgeable Linux terminal assistant that translates your natural language into shell commands without a single artificial neuron. Just type termy followed by your prompt:

[!TIP] If you want to expand the capabilities of TERMy check out the dataset directory and the TERMy documentation

Quick start to redemption

Reclaim control on your workflow in less than sixty seconds:

# Clone the forge from the cloud
git clone https://github.com/gioblu/NPC-Forge.git

# Step into the forge and install it
cd NPC-Forge && chmod +x setup.sh && ./setup.sh

# Install TERMy
npc-forge install npcs/termy

# Chat with TERMy
termy how are you

Consider that this experimental release of npc-forge works only on Linux and WSL.

[!WARNING] First experimental release of NPC-Forge distributed "AS IS" without any warranty, use it at your own risk.

Documentation

• TERMy
• FlintParser
• FlintNPC
• NPC-Forge CLI
• NPC-Forge API
• NDF 0.0 (NPC-Forge Dataset Format)
• TCS 0.0 (Terminal Commands Security)

Contributing to the forge

I am developing NPC-Forge with the conviction that democratic and sustainable use of Artificial Intelligence can be achieved with deterministic designs driven by curated and tested datasets crafted by the community; if you can, help me out. NPC-Forge thrives on your contributions, the community grows stronger when you:

• Extend the dataset of existing NPCs
• Craft new NPCs
• Optimize or extend the framework

Or are you just going to sit there waiting for the water to reach the boiling point?

License

Licensed under the AGPL-3.0, feel free to contact me directly for commercial licensing options. Let's see if your corporate checkbook can purchase an exemption.