run-locally

Run and test the Housing Assistant agent locally with uv and pytest.

4|Updated May 9, 2026
One-click install
npx skills add https://github.com/victorlou/housing-assistant --skill run-locally-victorlou
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: run-locally
Source: https://github.com/victorlou/housing-assistant/tree/main/app/app-templates/.claude/skills/run-locally
Command: npx skills add https://github.com/victorlou/housing-assistant --skill run-locally-victorlou

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you start the Housing Assistant agent locally and quickly verify that the server, API endpoints, and evaluation workflows are working during development and troubleshooting.

Core Features & Use Cases

  • Local server startup: Run the agent at http://localhost:8000 for immediate local testing.
  • Configurable runtime options: Use hot-reload, custom ports, and worker counts to match your dev workflow.
  • API verification: Test streaming and non-streaming /invocations requests with curl.
  • Evaluation and testing: Run agent-evaluate for MLflow scorers and execute unit tests with pytest.

Quick Start

Start the server locally by running the command: 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 run and test an agent locally for development troubleshooting?

Testing the /invocations API locally involves using curl to send streaming or non-streaming payloads against the server, verifying that the agent handles requests correctly before running further evaluations.

How do I test streaming and non-streaming invocations API endpoints with curl?

Testing the /invocations API locally involves using curl to send streaming or non-streaming payloads against the server, verifying that the agent handles requests correctly before running further evaluations.

Does local agent development support configurable runtime options like hot-reload and custom ports?

Yes, you can run MLflow evaluation scorers using the agent-evaluate command and execute unit tests with pytest to verify agent behavior and ensure the evaluation workflows are functioning correctly.

Can I run MLflow evaluation scorers and pytest for local agent verification?

Yes, you can run MLflow evaluation scorers using the agent-evaluate command and execute unit tests with pytest to verify agent behavior and ensure the evaluation workflows are functioning correctly.

What should I do if my local agent server encounters port conflicts or authentication issues?

A local development setup for the Housing Assistant agent requires the uv command tool to start the server and execute tests, providing a local environment to iterate on agent behavior and verify API endpoints.

What is the best way to start a Housing Assistant agent server on localhost for testing?

A local development setup for the Housing Assistant agent requires the uv command tool to start the server and execute tests, providing a local environment to iterate on agent behavior and verify API endpoints.