npcpy MCP Server

What is npcpy?

npcpy is a Python library that provides key primitives for research and development with multimodal language models, agentic AI, and knowledge graphs. It offers a flexible framework supporting local providers (Ollama, llama.cpp, ONNX, LM Studio) and cloud models, and includes a Context-Agent-Tool data layer to ensure compliance through software.

How to use npcpy?

Install with pip install npcpy. Then import classes such as NPC, Agent, ToolAgent, CodingAgent, and NPCArray to create personas, run direct LLM calls, build multi-agent teams, or manage knowledge graphs.

Key features of npcpy

• Create and use personas with the NPC class
• Direct LLM calls via get_llm_response()
• Agents with built-in tools (shell, Python, file editing, web search)
• Custom tool integration with ToolAgent
• CodingAgent for auto‑executing code blocks
• Multi‑agent debate and consensus with NPCArray
• Knowledge graph with sleep/dream lifecycle

Use cases of npcpy

• Historical figure simulation (e.g., Simon Bolivar persona for educational Q&A)
• Multi‑agent debate on complex problems (e.g., GSM8k math reasoning)
• Code generation and execution (duplicate file detection, exploratory scripting)
• Fine-tuning and generating images with diffusion models via ToolAgent
• Building evolving knowledge graphs from text corpora