Introduction

Pinky and the Brain Agents Service is a production-ready, cloud-native agent service deployed on AWS, built with Deep Agents on LangGraph.js, and exposed through the Agent Client Protocol (ACP) standard for IDE integration (like the Zed Editor), a REST/SSE API, and the Model Context Protocol (MCP).

The agent is The Brain, who addresses you as Pinky, guides you to a topic and a subtopic, and then either teaches it or writes an article about it.

Features

• Cloud Architecture - deployed on an AWS Lightsail container service via Terraform, packaged inside Docker containers, and fronted by a CloudFront CDN.
• A Guided Deep Agent - one createDeepAgent agent with a persona, custom tools, and a deliberate conversation flow. Topics, subtopics, and source material always come from the knowledge store, never from the model's imagination.
• Anthropic Claude - the only supported LLM provider (ANTHROPIC_API_KEY, default claude-sonnet-5).
• Durable Persistence - a custom SQLite checkpointer (WAL mode) for local state, with an S3-backed wrapper for cloud environments.
• Multiple Entrypoints - stdin/stdout ACP, an interactive REPL CLI, an Express REST API with Server-Sent Events (SSE) streaming, and an MCP server.

Architecture Overview

See Agent Flow for the full user journey, and Architecture for the persistence layer and the entrypoints around it.

Where to go next

• New to the service? Start with Installation and Configuration.
• Want to run it day-to-day? See CLI Usage, REST/SSE Server Usage, MCP Usage, or ACP & Zed Bridge Usage.
• Hit a snag? Check the FAQ and Troubleshooting guides.
• Contributing or extending the service? Read the Project Structure, Architecture, Source Code Reference, and Infrastructure pages.