python

Python — AI, Data, Automation

This command is part of the VibeHarness framework. Do NOT use for Node.js web projects. Use the frontend command for web apps. Verify stack matches PROJECT_RULES.md. Record architecture decisions in docs/ai-dev/.

Stack by Project Type

AI/RAG/Chatbot

pip install fastapi uvicorn langchain openai chromadb

project/
├── app.py              # FastAPI main
├── chains/             # LangChain chain definitions
├── models/             # Data models
├── static/             # Frontend (simple HTML)
├── requirements.txt
└── .env                # API keys

Data Analysis/Visualization

pip install streamlit pandas plotly

project/
├── app.py              # Streamlit main
├── data/               # Data files
├── utils/              # Analysis utilities
└── requirements.txt

API Server

pip install fastapi uvicorn sqlalchemy

project/
├── app.py              # FastAPI main
├── models.py           # DB models
├── routes/             # API routes
├── database.py         # DB connection
└── requirements.txt

Automation/Scraping

pip install beautifulsoup4 requests playwright

project/
├── main.py             # Main script
├── scrapers/           # Scraper modules
├── output/             # Result storage
└── requirements.txt

Initial Setup

# Create virtual environment (explain to non-dev: "creating a dedicated space for this project")
python -m venv venv

# Activate virtual environment
# Mac/Linux:
source venv/bin/activate
# Windows:
venv\Scripts\activate

# Install packages
pip install -r requirements.txt

Always provide full copy-paste commands when guiding non-developers through virtual environment setup.

FastAPI Basic Pattern

from fastapi import FastAPI
from fastapi.staticfiles import StaticFiles

app = FastAPI()

app.mount("/static", StaticFiles(directory="static"), name="static")

@app.get("/api/hello")
async def hello():
    return {"message": "Hello!"}

if __name__ == "__main__":
    import uvicorn
    uvicorn.run(app, host="0.0.0.0", port=8000)