quikform

Votre agent écrit le formulaire. quikform l’affiche.

Un petit serveur de formulaires open source. Votre agent IA écrit un fichier JSON, quikform le vérifie et sert un formulaire pensé pour le téléphone sur votre propre domaine. Chaque réponse arrive dans un fichier SQLite que votre agent peut relire.

  • Un seul exécutable
  • Moins de 100 Mo de RAM
  • Fonctionne sans JavaScript
  • Licence MIT
$ quikform form put \
    --project northwind accueil.json
ok accueil v1
Un formulaire d'accueil en deux étapes sur un téléphone : nom, email et une question à choix unique, avec un bouton Suivant vert et une barre de progression.
Le formulaire que décrit accueil.json, tel que quikform l’affiche sur un téléphone. Northwind Climbing est une marque d’exemple.

Comment ça marche

Vous décrivez le formulaire en une phrase. Votre agent fait le reste avec quatre commandes.

  1. Votre agent écrit un fichier JSON

    Les champs, les étapes, les conditions, le message de remerciement et la mention de confidentialité. Aucun HTML ni script.

  2. quikform check le relit

    Chaque erreur revient avec son emplacement exact dans le fichier : l’agent la corrige avant que quiconque voie le formulaire.

  3. form put le publie

    Le formulaire est en ligne sur votre domaine en dix secondes. Sa version augmente à chaque changement de contenu.

  4. Les réponses reviennent

    Chaque réponse est validée une seconde fois sur le serveur, enregistrée dans SQLite et, si vous le voulez, envoyée dans un groupe Telegram. quikform responses les donne à votre agent en JSON, et vous les lisez vous-même dans l’admin.

Afficher une étape de l’exemple
{
  "id": "accueil",
  "lang": "fr",
  "title": "Bienvenue chez Northwind",
  "privacy":
    "Vos réponses servent uniquement à préparer vos séances.",
  "access": "public",
  "notify": { "telegram": true },
  "steps": [
    { "title": "Vous", "fields": [
      { "id": "name", "type": "short_text",
        "label": "Votre nom", "required": true },
      { "id": "email", "type": "email",
        "label": "Email", "required": true },
      { "id": "level", "type": "single_choice",
        "label": "Avez-vous déjà grimpé ?",
        "options": [ … ] }
    ] },
    { "title": "Vos objectifs", "fields": [
      { "id": "injury", "type": "yes_no",
        "label": "Une blessure à nous signaler ?" },
      { "id": "injury_details", "type": "long_text",
        "label": "Dites-nous en plus",
        "showIf": { "field": "injury", "equals": true } }
    ] }
  ]
}
Étape 1 sur 2 : nom, email et niveau d'escalade remplis. Étape 2 sur 2 : oui à la question sur les blessures, ce qui fait apparaître le champ Dites-nous en plus.
$ quikform responses --project northwind --json
[
  {
    "id": 2,
    "created_at": "2026-10-23T09:21:53.139Z",
    "form": "accueil",
    "version": 1,
    "values": {
      "name": "Maya Okafor",
      "email": "maya@example.com",
      "level": "some",
      "injury": true,
      "injury_details": "Ancienne douleur à l'épaule, ça va mieux."
    }
  }
]

Ce qu’on en fait

Tout ce que vous récupérez aujourd’hui par email ou WhatsApp, puis recopiez à la main.

  • L’accueil d’un client

    Les nouveaux membres ou clients répondent une fois, sur leur téléphone, avant le premier rendez-vous. Votre agent lit les réponses et prépare la séance.

    short_text · email · single_choice · yes_no
  • Un formulaire de contact pour un site statique

    Le bouton « Contact » de votre site pointe vers formulaire.votresite.fr/contact. Les messages arrivent sur votre Telegram et restent dans votre base.

    email · long_text
  • Un questionnaire pour un seul client

    Tarifs, services, horaires : tout ce qu’un agent doit savoir sur une entreprise, demandé par étapes au lieu d’un long échange d’emails. Chaque personne reçoit son propre lien privé, et l’admin montre qui a répondu.

    number · multiple_choice · link create
  • Inscription à un cours ou un événement

    Un lien public à partager dans un groupe de discussion. Un champ piège invisible et une limite d’envois tiennent les robots à l’écart.

    short_text · email · single_choice
  • Un retour après une prestation

    Un court formulaire envoyé une fois le travail terminé. Les questions de suivi n’apparaissent que si une réponse les appelle.

    yes_no · long_text · showIf
  • Des demandes que votre agent traite

    Demandes de devis, réservations, dossiers d’inscription : les réponses arrivent en JSON structuré, prêtes pour l’agent qui s’en occupe.

    responses --json

Pourquoi si petit

  • Pourquoi un formulaire de contact demanderait-il un compte chez un autre service ?
  • Pourquoi votre agent cliquerait-il dans un éditeur visuel alors qu’il sait écrire un fichier ?
  • Pourquoi un serveur de formulaires aurait-il besoin de plusieurs gigaoctets de mémoire et de plusieurs bases ?
  • Pourquoi vos réponses vivraient-elles ailleurs qu’à côté de votre projet ?

quikform garde un fichier JSON par formulaire et un fichier SQLite par projet, sur votre serveur, derrière le serveur web que vous avez déjà. Les composants de champs sont écrits une fois et testés : chaque formulaire que votre agent écrit hérite de la même validation et du même confort sur téléphone.

Ce qu’il y a dedans

Ce qu’il faut à un formulaire pour être rempli sur un téléphone et vérifié sur le serveur.

Sept types de champs
Texte court, texte long, email, nombre, choix unique, choix multiple et oui ou non. Chacun peut être obligatoire, avoir des limites et un texte d’aide, ou n’apparaître que si une autre réponse l’appelle.
Vérifié deux fois
quikform check valide la définition avant la mise en ligne, et le serveur valide de nouveau chaque envoi. Un champ obligatoire masqué par une condition ne bloque jamais l’envoi.
Pensé pour le téléphone
Un formulaire court tient sur une page ; un long se découpe en étapes avec une barre de progression. Les labels restent visibles, le clavier s’adapte au champ, le bouton est sous le pouce. Les réponses en cours restent dans le navigateur jusqu’à l’envoi.
Fonctionne sans JavaScript
La page est rendue sur le serveur. Le petit script ajoute seulement les étapes, la validation en direct et les champs conditionnels.
Votre marque, pas la nôtre
Logo et couleur d’accent par projet, et aucune mention « propulsé par ». Aucun traceur ni bannière de cookies.
Alertes et confidentialité
Un message Telegram à chaque réponse. Une mention de confidentialité sur chaque formulaire, et des réponses supprimées après 12 mois par défaut.
Quatre langues
Textes de l’interface en anglais, français, allemand et thaï, choisis par formulaire.
Public ou privé
Un formulaire public répond à toute personne qui a son adresse. Un formulaire privé ne répond qu’aux liens que vous créez, un par personne et révocable, et chaque réponse garde le lien d’où elle vient.
Une admin en lecture seule
Derrière un mot de passe, sur téléphone ou sur ordinateur : vos projets, leurs formulaires, qui a répondu, les liens à partager avec un bouton Copier, et chaque réponse question par question. Elle ne modifie rien ; formulaires et liens restent l’affaire de votre agent.
Un domaine pour tous les projets
Réglez une fois un domaine de base et chaque projet répond sur son propre sous-domaine, comme salle.formulaire.example.com, avec un certificat HTTPS obtenu à la première visite. Un projet peut aussi garder son propre domaine.
Un skill pour votre agent
skills/quikform/SKILL.md indique à votre agent quand utiliser quikform et le guide pour écrire, vérifier, publier, créer des liens privés et lire les réponses. Liez-le dans Claude Code, ou indiquez-le à tout autre agent.
# un projet par domaine
$ quikform project init northwind \
    --domain formulaire.northwind.example \
    --accent "#2b6a4f"

# toute la boîte à outils de l'agent
$ quikform check accueil.json
$ quikform form put --project northwind \
    accueil.json
$ quikform responses --project northwind --json

# un formulaire privé : un lien par personne
$ quikform link create --project northwind \
    --form accueil --label "Maya"

# le serveur, derrière Caddy ou un autre proxy
$ quikform serve --port 8787

Chaque commande ne touche qu’un seul projet. Codes de sortie : 0 succès, 1 échec, 2 erreur d’utilisation.

Installation

Le plus rapide est l’image Docker toute prête, ghcr.io/jonathanvouilloz/quikform, pour Linux amd64 et arm64 : rien à cloner ni à compiler.

Sans Docker, compilez un seul exécutable depuis les sources avec Bun 1.4 ou plus récent, puis copiez dist/quikform sur votre serveur.

quikform n’écoute que sur 127.0.0.1 : placez Caddy ou un autre proxy devant pour le HTTPS. Le README détaille le service systemd, le bloc Caddy et l’activation de l’admin.

# avec Docker
$ mkdir quikform && cd quikform
$ curl -fsSLO \
    https://raw.githubusercontent.com/jonathanvouilloz/quikform/main/compose.yaml
$ echo "QUIKFORM_SECRET=$(openssl rand -hex 32)" > .env
$ docker compose up -d

# ou depuis les sources, avec Bun
$ git clone https://github.com/jonathanvouilloz/quikform
$ cd quikform
$ bun install
$ bun run build        # écrit dist/quikform

$ export QUIKFORM_HOME=~/.local/share/quikform
$ export QUIKFORM_SECRET=$(openssl rand -hex 32)
$ ./dist/quikform serve

Open source, licence MIT

Le code, le format des formulaires et les tickets sont sur GitHub. Copiez-le, hébergez-le, proposez vos modifications.

Voir sur GitHub