NPC-Forge is a neuro-symbolic AI agent framework that combines the capabilities of LLMs with the safety, efficiency and predictability of deterministic algorithms to deliver safe and efficient workflows. It runs on the CPU without necessarily relying on machine learning or LLMs.
Many problems you encounter can be solved without machine-learning or LLMs. NPC-Forge gives you the tools to solve those problems more efficiently:
- Deterministic engine: fast, safe and reliable deterministic engine to handle known questions.
- Probabilistic engine: uses ollama to answer questions that require reasoning or generative abilities.
- Extensible: craft datasets with ease thanks to the NDF 0.0 (NPC-Forge Dataset Format) specification.
- Continuous learning: NPCs learn and respond to known questions thousands of times faster than LLMs.
- Plug-and-play: implements an OpenAI-compatible API that connects NPCs to your favorite harness.
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 create # Creates new NPC using the example profile
npc-forge install <path> # Installs a new NPC
npc-forge dataset <npc> # Dataset package management
Additional information can be found in the NPC-Forge CLI documentation.
TERMy-24k is a Turing-complete, neuro-symbolic AI terminal assistant. It includes a deterministic engine used to answer known inputs in less than 50 milliseconds, and uses ollama as a probabilistic engine to answer unknown inputs.
TERMy-24k provides context to both deterministic and probabilistic engines and acts as a harness and a router:
It implements a "neuro helps symbolic" architecture in the "learning‑for‑reasoning" family.
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 youConsider that this experimental release of npc-forge works only on Linux and WSL.
Warning
This is the second experimental release of NPC-Forge distributed "AS IS" without any warranty, use it at your own risk.
- TERMy
- FlintParser
- FlintNPC
- NPC-Forge CLI
- NPC-Forge API
- NDF 0.0 (NPC-Forge Dataset Format)
- TCS 0.0 (Terminal Commands Security)
- NPC creation guide
I am developing NPC-Forge with the conviction that democratic and sustainable use of Artificial Intelligence can be achieved with neuro-symbolic designs driven by curated and tested datasets crafted by the community; if you can, help me out.
Or are you just going to sit there waiting for the water to reach the boiling point?
The following list contains the contributors; with their support, expertise, kindness and talent NPC-Forge and TERMy are getting better by the day: Fred Larsen, Kevin Mathis, Cristiano Pizzarelli, David Starkweather, SyN-droMe, AnonymousMonkeyNo12
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.