NPC-Forge README

The project's README from github.com/gioblu/NPC-Forge. As one markdown file: README.md.

NPC-Forge Discord

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:

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 create         # Creates new NPC using the example profile
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:

Terminal demonstration

You can also write a script in plain english, create a file test.termy with the following content:

search on wiki the programma 101
append it to p101.txt
open it in the browser

Then digit termy -y < test.termy and watch TERMy transpile it to a Shell script and execute it.

[!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

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:

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

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.

NPC-Forge (gioblu/NPC-Forge)

Searching Database…

269 ·GitHub
NPC-Forge
Что это такое?NPC-Forge — это опенсорсный нейросимвольный фреймворк для создания диалоговых агентов с выраженным характером, поддержкой многоходового контекста, анализа тональности и вызова инструментов. Его агенты работают на процессоре без машинного обучения и LLM.
Это фреймворк, на котором я буду что-то строить, или готовый ассистент, который можно просто запустить?Это фреймворк: вы создаёте NPC и управляете ими через NPC-Forge CLI, описывая их датасеты в формате NDF 0.0. В комплекте также есть готовый ассистент TERMy, встроенный прямо в фреймворк.
Как быстрее всего его попробовать?Установите его на Linux или WSL и следуйте инструкциям быстрого старта — по словам авторов из README, это займёт меньше минуты. Всё управление идёт через терминальные команды NPC-Forge CLI. Затем просто наберите 'termy' и свой запрос.
Он работает на macOS или Windows?Нативно нет: текущий экспериментальный релиз работает только на Linux и WSL и распространяется как есть, без каких-либо гарантий. А поскольку агенты детерминированы, они не могут галлюцинировать — но и умеют ровно то, что покрыто их датасетом.
Можно ли бесплатно использовать его в коммерческих целях?Проект распространяется по лицензии AGPL-3.0, поэтому для опенсорсных проектов он бесплатен; для коммерческого лицензирования автор просит связаться с ним напрямую.
Почему автор сделал детерминированных агентов вместо того, чтобы использовать LLM?Он считает, что многие задачи эффективнее решаются без машинного обучения, и что устойчивое и доступное применение ИИ достигается за счёт детерминированных решений, основанных на курируемых датасетах, проверенных сообществом, а не на надежде, что модель поведёт себя как надо.
Чем это отличается от NLP.js?Согласно README, NPC-Forge гораздо лучше справляется с опечатками, грубыми выражениями, междометиями и перестановкой слов, чем NLP.js, и при этом отвечает за миллисекунды прямо на процессоре.
Насколько проект зрелый?Проект пока на ранней стадии: текущий релиз прямо помечен как экспериментальный и поставляется без гарантий, но уже есть документация по CLI, API, FlintParser, FlintNPC, спецификациям NDF и TCS, а также список активных контрибьюторов.
What are similar projects?Proteus, OpenIntelligentUI, turnstone, rasa, CopilotKit, aichat, tambo, agentscope
Which topics is it in?wsl, assistant, cpu, tool-calling, embedded-systems, lightweight, natural-language-processing, agent-framework, openai-compatible, nlp, agpl, chatbot
Creator
gioblu
Size
56.6 MB
Stars
269
Updated
CommitOct 14Release0.1Oct 07
Age
2mo
Commits · 90 Days