Documenta il codice con l’IA
Uno strumento che legge il tuo codice sorgente e scrive la documentazione al posto tuo: docstring per funzioni e classi, commenti sui passaggi poco ovvi e una breve spiegazione di cosa fa ogni blocco. Utile a chi sviluppa da solo o in team e non ha tempo di commentare tutto a mano.
Esegui online
Esegui questo sui nostri server con il tuo account. Gli strumenti gratuiti girano nel tuo browser; questo viene addebitato sul tuo saldo KIT al prezzo indicato sopra.
Incolla il codice, scegli la lingua dei commenti
Funziona con i linguaggi più diffusi — Python, JavaScript, TypeScript, PHP, Java, Go — e riconosce da solo la sintassi. Incolli la funzione o l’intero file nella pagina e scegli in che lingua vuoi i commenti: italiano, inglese o altre. Il KIT non tocca la logica: aggiunge documentazione sopra e dentro il codice, lasciando intatto ciò che gira.
Docstring, non righe a caso
Per ogni funzione genera una docstring nel formato giusto per il linguaggio: parametri, valore di ritorno, eccezioni e una riga che spiega lo scopo. Nei punti poco ovvi — una regex, un calcolo di scadenze, un ciclo annidato — aggiunge un commento breve che dice il perché, non il come. Niente commenti inutili tipo “incrementa i” che sporcano il file.
Perché conviene rispetto a farlo a mano
Documentare è la prima cosa che salta quando c’è una scadenza. Il risultato è un progetto che sei l’unico a capire e che, sei mesi dopo, non capisci più nemmeno tu. Passare il codice qui prima di un merge ti dà una base già commentata da rivedere in pochi minuti, invece di partire dal foglio bianco. Tu resti il revisore: leggi, correggi dove serve, salvi.
Costi e formato in uscita
Il prezzo è a consumo: $0.003 a richiesta più $0.0135 ogni 1.000 parole di codice, senza abbonamento. In uscita ricevi lo stesso file con la documentazione già inserita, pronto da incollare nell’editor. Puoi passarlo dalla pagina web oppure, se lo integri nel tuo flusso di lavoro, via API allo stesso prezzo.
Casi d'uso
Il gestionale che hai ereditato
Riprendi in mano un gestionale scritto anni fa per lo Studio Commercialista Bianchi, senza un commento. Passi i moduli uno alla volta e ottieni docstring su ogni funzione: capisci di nuovo il codice prima di metterci mano.
Onboarding di un nuovo collega
Un nuovo sviluppatore entra in Tecnoedil Verona e deve orientarsi nel repository. Documentare le classi principali prima del suo arrivo gli fa risparmiare giorni di domande e ti evita di spiegare tutto a voce.
Prima di pubblicare una libreria
Stai per rendere pubblico un pacchetto: le docstring diventano la documentazione che gli altri leggeranno. Le generi in inglese in un passaggio e le rifinisci, invece di scriverle da zero funzione per funzione.
Domande frequenti
In che lingua scrive i commenti?
Nella lingua che scegli: italiano, inglese o altre. Molti team preferiscono i commenti in inglese anche su progetti italiani, per il codice condiviso — decidi tu a ogni richiesta.
Modifica il mio codice o solo i commenti?
Solo la documentazione. La logica resta identica: aggiunge docstring e commenti, non riscrive né “ottimizza” le funzioni. Quello che gira prima gira uguale dopo.
Quanto costa davvero?
$0.003 a richiesta più $0.0135 ogni 1.000 parole di codice. Paghi solo quello che elabori, a prezzo pubblicato, senza abbonamento né minimo mensile.
Dove finisce il codice che incollo?
Il file viene elaborato per generare i commenti e poi eliminato: non lo conserviamo né lo usiamo per altro. Se il codice è riservato, valuta comunque cosa incolli, come faresti con qualsiasi strumento online.
Funziona con qualsiasi linguaggio?
Con i più diffusi sì — Python, JavaScript, TypeScript, PHP, Java, Go, C#, Ruby. Con linguaggi molto di nicchia il risultato è più grezzo: conviene rileggerlo con attenzione.
Posso usarlo dal telefono?
Sì, si usa dal browser del telefono senza installare niente. Per file lunghi è più comodo da computer, ma per una singola funzione va bene anche da mobile.
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
curl -X POST https://api.kit.forhosting.com/dev/code-document \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"…"}'const res = await fetch("https://api.kit.forhosting.com/dev/code-document", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"text": "…"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/dev/code-document",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"text": "…"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev/code-document", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"text":"…"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"text":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev/code-document", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Esempio di richiesta
{
"text": "…"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "dev.code_document",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |
422 | task_failed | L'attività non è andata a buon fine: non ti viene addebitato nulla. |