Npcpy

About

`npcpy` is a Python library for building agent-based AI systems. It provides interfaces for using, testing, and exploring AI models, agents, and agent systems, including support for local and enterprise LLM providers like Ollama, LMStudio, OpenAI, Anthropic, Gemini, and Deepseek. `npcpy` also includes the NPC Shell (`npcsh`), a suite of command-line tools for interacting with NPCs and LLMs. With programs such as `npcsh`, `guac`, `npc`, `alicanto`, and `pti`, `npcpy` supports a range of applications from web searching and image generation to computer use and interactive coding.

Key Features

• Agent-based framework for integrating AI models
• Supports local and enterprise LLM providers through LiteLLM integration
• Includes NPC Shell (`npcsh`) with command-line tools
• `guac` shell for interactive coding with a pomodoro-like approach
• Supports images, PDFs and CSVs in LLM response generation
• 603 GitHub stars

Use Cases

• Automating tasks using AI agents
• Building custom AI assistants
• Integrating AI into coding workflows