What Fito is
Fito develops technical discernment: the ability to spot nuance, weigh trade-offs, and reach for the right solution in the right context. You work through code-based cases, get assessed against an explicit map of knowledge, and watch your proficiency accumulate.
This is the complete account of how to use Fito, in English and Portuguese. It is authoritative wherever anything else covers the same ground.
It does not explain how to run or operate a Fito server. That is an operator’s job, and it lives in the repository’s own architecture documentation.
How Fito works
Section titled “How Fito works”You browse Fito in a browser and work a case in your terminal.
- Pick a case from the catalogue. Its cover tells you what it teaches, what it expects you to know already, and how it will score you.
- Open it in your terminal. Fito forks the case to your GitHub, checks it out on a branch of your own, and briefs you on the situation — never the solution.
- Solve it, with a tutor scoped to that case when you get stuck.
- Submit. Your work is scored against the case’s rubric, and the result is recorded as proficiency against individual pieces of knowledge rather than as a single mark.
Every AI turn — the tutor, the scoring — runs on your own machine on your own LLM subscription. Fito’s server holds no LLM key and never sees your code.
Start here
Section titled “Start here”New to Fito? Two pages get you working:
- Install and prerequisites — what you need, and the four commands that install it.
- Play your first case — the whole path in six steps.
Once you are working, the Action refcard holds every Fito action on one page, in the order you run them.
Find your way around
Section titled “Find your way around”The seven sections above are audiences. Pick the one that describes what you are doing.
| Section | For you if you are… |
|---|---|
| Start here | Installing Fito and working your first case |
| Learn with Fito | Working cases: signing in, finding one, the tutor, submitting, your data |
| Knowledge model | Reading Fito’s vocabulary — what a knowledge component, a competence or a Bloom level is |
| Author knowledge | Adding a technology and its knowledge to Fito |
| Author a case | Designing, generating, publishing and maintaining a case |
| Curate and administer | Voting, triaging what learners flag, running the dashboards |
| Reference | Looking up a command, a route or a file — and troubleshooting |
If a word in these pages is unfamiliar, it is defined once in the glossary.
Read it in Portuguese
Section titled “Read it in Portuguese”Every page here exists in Brazilian Portuguese. Use the language switcher in the top bar, or go straight to o guia em português.