run-locally

Start a localhost server to test agent API invocations with JSON payloads.

2|Updated Apr 6, 2026
One-click install
npx skills add https://github.com/bcheng004/agent-langgraph-advanced-workshop --skill run-locally-bcheng004
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: run-locally
Source: https://github.com/bcheng004/agent-langgraph-advanced-workshop/tree/main/.claude/skills/run-locally
Command: npx skills add https://github.com/bcheng004/agent-langgraph-advanced-workshop --skill run-locally-bcheng004

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

You need a fast way to run the agent on your machine and verify that the API, configuration, and local tooling are working correctly.

Core Features & Use Cases

  • Start the local server: Launch the agent on localhost for iterative development and validation.
  • Test streaming and non-streaming invocations: Use curl requests to quickly confirm request/response behavior.
  • Run evaluation and unit tests: Validate quality with MLflow scorers and confirm correctness with pytest.
  • Troubleshoot common local errors: Resolve port conflicts, authentication issues, missing modules, and MLflow experiment configuration problems.

Quick Start

Start the agent locally by running: uv run start-app.

Frequently Asked Questions about run-locally

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I test API streaming responses during local agent development?

To test streaming responses during local agent development, launch the server with uv run start-app and send curl requests with JSON payloads to the localhost /invocations endpoint to verify streaming and non-streaming behavior.

Why does my local agent server fail to start due to port conflicts or missing modules?

Port conflicts or missing modules during local server startup are common configuration errors. Troubleshoot these local errors by verifying port availability, ensuring proper module installation, and checking your .env authentication setup.

Can I use MLflow to run evaluation scorers on a locally hosted agent?

Yes, you can use MLflow to run evaluation scorers on a locally hosted agent. Start the server locally, then invoke the evaluation tests to validate response quality and track experiment configurations using MLflow.

What is the best way to verify agent configuration and API correctness on localhost?

The best way to verify agent configuration and API correctness on localhost is to run the server locally, test invocations with curl, and execute unit tests with pytest to confirm the endpoint behaves correctly.

Do I need uv run commands to start the development server for API testing?

Yes, you need uv run commands to start the development server for API testing. Launching the agent on localhost requires using uv-run commands to start the app and invoke the Responses-compatible endpoint.

How do I troubleshoot .env authentication issues when running an agent locally?

To troubleshoot .env authentication issues when running an agent locally, verify your .env file configuration and ensure all required environment variables are loaded correctly before starting the local development server.