npcpy
by NPC-Worldwide
Overview
A comprehensive Python library and framework for building, evaluating, and serving LLM-powered agents and multi-agent systems, integrating fine-tuning capabilities, knowledge graphs, and scalable model operations, with a built-in Flask API server for deployment.
Installation
python examples/team_serve_example.pyEnvironment Variables
- OPENAI_API_KEY
- ANTHROPIC_API_KEY
- DEEPSEEK_API_KEY
- GEMINI_API_KEY
- PERPLEXITY_API_KEY
- EXA_API_KEY
- ELEVENLABS_API_KEY
- NPCSH_API_URL
- CUSTOM_PROVIDER_*
Security Notes
The server exposes `execute_llm_command` and Jinx `python` engine steps, which can execute arbitrary shell commands (`subprocess.run(..., shell=True)`) and Python code (`eval(...)`) respectively, based on LLM output. This is a critical remote code execution vulnerability if not rigorously sandboxed and input-validated. The example server setup uses `cors_origins=['*']`, which is insecure for production. Direct LLM-to-bash execution without user confirmation or strong sandboxing is extremely dangerous.
Similar Servers
MaxKB
An enterprise-grade intelligent agent platform for building knowledge bases, RAG, complex workflows, and AI agents, targeting intelligent customer service and office assistants.
arcade-mcp
A framework and collection of toolkits for building and deploying AI agent servers that integrate with various external services.
mcp_massive
An AI agent orchestration server, likely interacting with LLMs and managing multi-agent workflows.
AgentUp
AgentUp is an infrastructure framework for developing, deploying, and managing production-ready AI agents, providing Docker-like consistency, security, and extensibility.