fais

fais is a command-line LLM-based AI agent for day-to-day operations.

Features

• Agents.md loading
• Text file reading and updating
• Docx, odt file reading and updating
• Draft emails with Thunderbird compose CLI
• Explore folders

Local install

For the project virtual environment:

uv sync

This is enough for uv run fais ..., but it does not make a globally available fais command auto-update from your working tree.

For a globally available fais CLI that tracks local code changes:

./install-dev.sh

If fais is still not found after installation, add uv's tool executables to your shell:

uv tool update-shell

Built version

./build.sh

Usage

fais "prompt" ./file1 ./file2

Main technologies and dependencies

• LangChain for the agent loop
• uv for setup
• Good old code, limited use of AI except for debugging annoying errors
• rich for proper text display (inspired by Mistral Vibe use of textualize)
• prompt_toolkit for handling human-in-the-loop interaction (inspired by questionary)

References and docs

• https://setuptools.pypa.io/
• https://docs.langchain.com/
• https://docs.astral.sh/
• https://python-prompt-toolkit.readthedocs.io/
• https://rich.readthedocs.io/en/latest/

About

"Fais" is French for "do" and pronounces pronounces "[fɛ]", like "fay" without the "y" part. Do not pronounce the "s" or the French will mock you for some reason, and it will be conflated with "FAISS" library of algorithms. You can listen to the proper pronounciation here.