NPC Studio

NPC Studio is an AI IDE that lets users have AI conversations, edit files, explore data, execute code, and much more.

Executables available for Linux, MacOS (Soon), and Windows at our website.

Installation

When installed via the executables or if you manually build npc-studio yourself, then it will be available as

npc-studio

Requirements

• Node.js 16 or higher
• Python 3.8 or higher (for the backend)
• Ollama (optional, for local models)

Chat with Agents and organize by project path

• NPC Studio gives users the capability to organize their conversations with AI agents in a natural and convenient way. Users can easily change working directories and separate their conversations by project path.

See thinking traces from agents:

• Aggregate conversations:

• Aggregate messages (to come)

Create and manage agents, tools

• NPC Studio uses the npcsh agent framework to simplify the building and orchestration of AI agents.

• Additionally, users can create and manage tools to be used by agents.

Edit plain text files

• NPC Studio is not just a chat interface, users can also edit plain text files (with agent-based integrations soon to come).

Edit settings

Global Settings

Project Settings

-When working in a specific folder, NPC Studio will discover an .env fiel if it's present and will use these API keys to determine which models can be used within the project.

Activity Dashboard (planned)

• view key activity metrics

Knowledge Graph (planned)

• view the knowledge graph built up over time through your actions

Use mixtures of agents (planned)

Exploratory data analysis (planned)

Automate with cron jobs and system daemons (planned)

Getting Started with Development

NPC studio is electron-based frontend with a python flask backend.

Before getting started with development, ensure that you have the following installed

• npcsh
• node+npm
• ollama (if you plan to rely on local models)

git clone https://github.com/cagostino/npc-studio.git

npm install

Start the electron backend:

npm run dev

Start the flask backend:

npc serve -p 5337 -c 'localhost:5137' # the -c indicates the url of the frontend so that the server can use CORS

Alternatively use the wrapper script that is provided

python npc_studio_serve.py

Start the electron frontend:

npm start

Build

npm run build

This will build the frontend and backend into a single executable file. In its current state, it specifies a build target for creating .deb and AppImage files in linux. Other OS to be added in the future.

License

NPC Studio is licensed under AGPLv3 with additional terms explicitly prohibiting the offering of third-party SaaS services which provide a user access to any web-hosted version of the software as well as prohibiting the packaged re-sale of the product. Please see the LICENSE file for further details.

items to do...

• letting ppl see lineage in npc team
• database overview tab