FLASH CLI
Local-first agent shell that chats with Ollama models via CLI and web UI with tools.
Tested on macOS and Linux
Use it
macOS arm64
git clone Flash repo to get requirements.txt
git clone https://github.com/Natuworkguy/Flash /tmp/flash-repo && ls /tmp/flash-repo && cat /tmp/flash-repo/requirements.txtpip3 install --break-system-packages -r requirements.txt
pip3 install --break-system-packages -r /tmp/flash-repo/requirements.txt && pip3 show ollamapip3 install --break-system-packages -e . to install flash package
pip3 install --break-system-packages -e /tmp/flash-repo && flash --help; echo HELP_EXIT:$? flash --version
Where the README and reality differ
- README: pip install -r requirements.txt installs Flash
What worked: requirements.txt only installs dependencies; need pip install -e . to provide `flash` entry point
Check that it works
flash --versionThe output should contain “Flash CLI v0.5.12”.
First thing to try
printf "/bye\n" | flashRun flash to start a chat session in the terminal, and type /bye to exit.
Linux x86_64
Clone repo for pip install
git clone https://github.com/Natuworkguy/Flash flash-srcInstall deps via pip candidate 1
python3 -m pip install -r flash-src/requirements.txtInstall flash package so flash is on PATH
python3 -m pip install ./flash-src && flash --version
Check that it works
flash --versionThe output should contain “Flash CLI v0.5.12”.
First thing to try
flash --extension-listRun flash to start a chat session in the terminal, and type /bye to exit.
What it does
- Chat with local models in the terminalNot tested
- Run shell commands through the AINot tested
- Build 3D models from promptsNot tested
- Talk to Flash by voiceNot tested
How far pickfit got
macOS arm64
- Installs
- Starts
- 0 of 4 features work
- Works offline
Linux x86_64
- Installs
- Starts
- 0 of 4 features work
- Works offline
Other systems
Windows: the project says it runs there; pickfit hasn’t tried it.
Good for
- chat with local Ollama models from the terminal
- execute shell commands with ! prefix
- send a local image to a vision model
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
macOS arm64
Its main function works
- Replayed from scratch
- Works offline
- Checked on 1 Nov 2026
- Version 0.5.12
Differences the test machine hit
- README: pip install -r requirements.txt
In the test: pip3 install --break-system-packages -r requirements.txt (Homebrew Python is externally-managed, PEP 668)
Linux x86_64
Its main function works
- Replayed from scratch
- Works offline
- Checked on 30 Oct 2026
- Version 0.5.12
Differences the test machine hit
- README: pip install -r requirements.txt then python3 run.py
In the test: also run pip install ./flash-src to provide flash on PATH; requirements.txt alone only enables python3 run.py