Original en anglais: https://argusic.com/subject/readme-ai
readme-ai
Générateur de fichier README, propulsé par l'IA.
Fonctionnesource : GitHubpage d'accueilPythonMITcommit 6f507b5f8779
Python, sous licence MIT. Le projet se décrit ainsi : agents, ai, ai agents, ai documentation, anthropic, badge generator, cli et developer tools.
readme-ai fonctionne. Un agent Argusic l'a installé en 20 minutes et a rencontré 5 erreurs, toutes corrigées sans aide sur une machine propre sans GPU, et toute la session a été enregistrée.
readmeai installs in a venv, passes its full 373-test suite, and generates README output files via the CLI in offline mode. The pyproject.toml dependency bounds were relaxed from caret to minimum versions to avoid Rust-compiler requirements for newer prebuilt wheels.
Ce que l'agent a obtenu sur une machine propre, dans ses propres mots. Comment c'est mesuré
Mesuré par Argusic sur une machine vierge, à chaque fois. Chaque chiffre renvoie à ses preuves. Score Argusic de 100 sur 100 (la moyenne des scores des exécutions de ce projet).
En un coup d'œil
Données du projet issues de GitHub, avec un lien en haut de cette page, mis à jour le . Données de test d'Argusic (CC BY 4.0) ; chaque chiffre renvoie à une page d'exécution avec le log complet, l'enregistrement et leurs empreintes sha256.
Ce qui a été mesuré
Tiré de l'exécution qui a décidé ce verdict. Chaque ligne est une valeur enregistrée, pas une estimation.
Ce qui s'est mal passé, dans les mots de l'agent
Les propres mots de l'agent, le plus grave en premier, jamais réécrits en conseils.
- tiktoken failed to build from source (no Rust compiler)5 minutes
- Missing click and other runtime deps (dependency resolver didn't install them due to version conflicts)3 minutes
- poetry.core.masonry.api missing for editable install1 minute
- Missing optional anthropic package1 minute
- Missing optional google-generativeai package1 minute
- Temps d'installation
- 20 minutes
- De la machine vierge à la fin
- 5 minutes
- Erreurs rencontrées et corrigées
- 5 rencontrées, 5 corrigées sans aide humaine
- Comment le résultat a été prouvé
- pytest: 373 passed, 5 skipped, 0 failed. readmeai --version prints 0.6.0.rc1. readmeai --repository . --api offline --output /tmp/test_readme.md generated a 42791-line README.md file without errors.
- Tokens de modèle utilisés
- 65 385
- Commit exact testé
- 6f507b5f8779
- Image de conteneur
- sha256:cdd920bce783
Ce qui n'a pas été mesuré
L'autre moitié, pour que vous voyiez exactement jusqu'où vont ces preuves. Une lacune est affichée comme une lacune et n'est jamais comblée.
- Pic de mémoire GPU
- cette exécution a eu lieu sur une machine CPU, il n'y avait donc pas de GPU à mesurer
- Comportement sur une longue durée
- chaque tentative utilise les réglages documentés les plus légers et un budget de temps fixe : on mesure donc s'il fonctionne, pas comment il tient sous la charge
La fin de l'enregistrement
Les dernières lignes de la session de terminal qui a décidé ce verdict, exactement telles qu'elles ont été enregistrées.
succeeded in 904ms: readmeai version 0.6.0.rc1 All tasks completed successfully. Here's the summary: **Install:** Created a venv, configured dependencies, relaxed overly tight version pins in `pyproje… **Launch:** `readmeai --version` prints `0.6.0.rc1`, `readmeai --help` lists all options, and runni… **Tests:** `pytest` reports **373 passed, 5 skipped, 0 failures**. tokens used 65,385 All tasks completed successfully. Here's the summary: **Install:** Created a venv, configured dependencies, relaxed overly tight version pins in `pyproje… **Launch:** `readmeai --version` prints `0.6.0.rc1`, `readmeai --help` lists all options, and runni… **Tests:** `pytest` reports **373 passed, 5 skipped, 0 failures**.
Revoir toute la session, chaque commande depuis une machine propre jusqu'à ce point.
Comment le test a été mené
Un agent, un conteneur, aucune aide humaine. Il installe le projet comme l'indique sa propre documentation, l'exécute et corrige ce qui casse. Tout ce qui suit est enregistré tel que cela s'est passé : la session de terminal, le log et le commit exact. La méthode complète.
Points forts et limites
Des faits mesurés, pas des opinions. Comment ce site est rédigé.
Ce qui s'est bien passé
- A atteint un état de fonctionnement sur une machine propre, avec la session enregistrée.
- S'est remis des 5 erreurs sans intervention humaine, ce qui indique que les échecs sont assez bien documentés pour être résolus.
- A fonctionné sans GPU, il n'en a donc pas besoin pour démarrer.
- Sous licence MIT, selon son hébergeur.
Ce qui ne s'est pas bien passé, ou n'est pas connu
- Installation en 20 minutes, plus lente que la médiane des 37 projets comparables mesurés par Argusic.
- Mesuré une seule fois jusqu'ici. Une seule tentative montre qu'il peut fonctionner, pas qu'il fonctionne de façon fiable.
Sur les 38 projets agents qu'Argusic a installés et chronométrés, readme-ai a été le 32e plus rapide à atteindre un état de fonctionnement, et 25 sur 38 en ont atteint un.
Pour quoi c'est un choix raisonnable
- L'essayer sur un ordinateur portable ou un petit serveur : il a atteint un état de fonctionnement sans GPU.
Également testés, dans le même domaine
Chacun de ces projets a été installé et exécuté par Argusic sur une machine propre. Rien n'apparaît ici sans avoir été testé.
Historique des exécutions
| testé par | tentative | résultat | score | coût USD | date |
|---|---|---|---|---|---|
| Argusic Runner | 1/3 | Fonctionne | 100,00 | 0,04 |
Sujets (depuis GitHub)
agentsaiai-agentsai-documentationanthropicbadge-generatorclideveloper-toolsdevtoolsdocumentationdocumentation-generatorgeminigptmarkdownmarkdown-generatorpythonreadmereadme-generatorreadme-md-generatorreadme-template
Intégrer le badge
Markdown pour le README du projet. Il renvoie vers cette page ; conditions sur la page des conditions.
[](https://argusic.com/subject/readme-ai)Questions
- readme-ai fonctionne-t-il ?
- Oui. readme-ai fonctionne. Argusic l'a installé et lancé sur une machine propre en 20 minutes, en rencontrant 5 erreurs en route, et a enregistré la session.
- Comment Argusic a-t-il testé readme-ai ?
- Sur une machine vierge et jetable, avec chaque commande enregistrée et le dépôt épinglé au commit 6f507b5f8779. Une tentative est enregistrée, et la méthode complète se trouve sur la page de méthodologie.
- Combien a coûté le test de readme-ai ?
- L'exécution qui a produit ce verdict a coûté 0,04 USD : le coût réel du calcul et du modèle, pas un prix catalogue par million de tokens. Il est enregistré sur la page de cette exécution.
- Combien de temps faut-il pour installer readme-ai ?
- 20 minutes lors de l'exécution qui a décidé ce verdict, d'une machine propre à un état de fonctionnement. Il s'agit d'une tentative mesurée, pas d'une moyenne.
- readme-ai a-t-il besoin d'un GPU ?
- Pas pour démarrer. Argusic a atteint un état de fonctionnement sur une machine sans GPU.
- Qu'est-ce qui pose problème lors de l'installation de readme-ai ?
- 5 problèmes sont survenus lors de l'exécution enregistrée, et 5 ont été corrigés sans aide humaine. Chacun, avec le temps qu'il a coûté, est listé sur cette page.
- Comment readme-ai se compare-t-il aux alternatives ?
- Sur les 38 projets agents qu'Argusic a installés et chronométrés, readme-ai a été le 32e plus rapide à atteindre un état de fonctionnement, et 25 sur 38 en ont atteint un.
- Où sont les preuves pour readme-ai ?
- L'exécution enregistrée se trouve sur cette page, chacune avec un lien vers son log complet et son enregistrement du terminal, conservés avec une empreinte sha256 pour qu'ils ne puissent pas être modifiés discrètement.