PySkill Backend Service

A minimal FastAPI backend service with multiple demo endpoints and pytest-based tests.

Tech Stack

• Python 3.9+
• FastAPI
• Uvicorn
• Pytest

Project Structure

pySkill/
├── app/                     # Application code
│   ├── __init__.py
│   └── main.py              # FastAPI app and routes
├── tests/                   # Test cases
├── scripts/
│   └── test.sh              # Test runner script
├── skills/                  # Reusable AI workflow docs
├── requirements.txt
└── agent.md                 # Repository agent instructions (AGENTS.md)

Setup

1. Create and activate a virtual environment.
2. Install dependencies:

pip install -r requirements.txt

Run Locally

Start the API server from the pySkill directory:

uvicorn app.main:app --reload

Default URL:

• http://127.0.0.1:8000

API Endpoints

• GET /health -> {"status": "ok"}
• GET /hello -> {"message": "hello"}
• GET /huanglin -> {"message": "huanglin"}
• GET /lastOne -> {"message": "lastOne"}
• GET /wold -> {"message": "wold"}

Quick check examples:

curl http://127.0.0.1:8000/health
curl http://127.0.0.1:8000/hello
curl http://127.0.0.1:8000/huanglin
curl http://127.0.0.1:8000/lastOne
curl http://127.0.0.1:8000/wold

Testing

Preferred command:

bash scripts/test.sh

Alternative:

python3 -m pytest

Notes

• Keep route handlers thin and changes minimal, following agent.md.
• Add tests for every new feature under tests/.