Template Universale di Documentazione
Documentazione dei Micro-Tool
Il layout di riferimento con cui arriva ogni asset PyForge — la stessa struttura che vedi quando apri il README di qualsiasi tool del vault.
Panoramica e Problema Risolto
Ogni pagina asset si apre con il problema che elimina: quale attività ripetitiva automatizza, per chi è pensata (sviluppatori, founder, marketer) e il risultato misurabile — ore risparmiate a settimana, errori eliminati, workflow sostituiti.
Resta concreto: un paragrafo sul problema, uno sull'approccio, una frase su cosa c'è nella scatola.
Quickstart e Installazione
Tre passi, sempre la stessa forma — dallo ZIP all'esecuzione in meno di due minuti:
1 — Estrai e crea l'ambiente
unzip your-tool_v1.zip && cd your-tool
python -m venv .venv && source .venv/bin/activate2 — Installa le dipendenze
pip install -r requirements.txt3 — Configura ed esegui
cp .env.example .env # add your keys
python main.py --runQuick Start — Usalo in Progetti e Agenti AI
Ogni tool PyForge gira con puro Python 3.8+ usando solo la Standard Library. Nessuna dipendenza esterna, nessun pip install.
1 — Esecuzione diretta e integrazione agentica
Lancialo come utility standalone o chiamalo direttamente dai tuoi agenti AI e script:
python main.py2 — Importalo nel tuo codice / progetto
Trascina il singolo file nella cartella del tuo progetto e importalo nativamente:
from main import AssetClassCome lo usano agenti e programmi: Siccome ogni tool si basa solo sulla Standard Library di Python, i tuoi agenti LLM (LangChain, AutoGen o runtime custom) possono eseguirli come subprocess isolati o importarli direttamente — nessun conflitto di dipendenze, nessun virtual environment.
Opzioni di Configurazione e Architettura
Ogni parametro regolabile vive in .env o in una tabella di flag: chiavi API, intervalli, percorsi di output, politica di retry. Nessuna costante magica sepolta nel codice.
# .env.example
API_KEY=
SCHEDULE_INTERVAL=3600
OUTPUT_DIR=./reports
MAX_RETRIES=5L'architettura resta piatta di proposito: main.py orchestra, un modulo per ogni responsabilità (fetch, transform, export), tutto tipato e testabile. Lo estendi per un cliente in un pomeriggio, non in uno sprint.
Licenza Commerciale e Supporto
Ogni asset include una licenza commerciale a vita: progetti personali e per clienti illimitati, nessuna royalty, nessuna attribuzione. La ridistribuzione del sorgente è l'unica cosa esclusa — termini completi nella pagina Termini di Servizio .
Supporto: support@py-forge.com — risposta entro 24 ore nei giorni lavorativi.