A fun, fuzzy-learning CLI bot written in Rust. It stores your name, answers fuzzy queries, does math, and even speaks responses!
- Learns anything you teach it
- Saves your name + data to JSON
- Fuzzy-matches questions
- Solves math expressions
- CSV / Markdown export & import
- Text-to-speech responses
- Colored, styled terminal UI
Make sure to install espeak
for text-to-speech support on Linux/macOS:
sudo apt install espeak
Windows users should have PowerShell 5+ (usually pre-installed).
🛠️ Build Instructions Build for your current platform (native build)
cargo build --release
The executable will be in:
Linux/macOS: ./target/release/minimal_ai
Windows: .\target\release\minimal_ai.exe
Cross-compiling Windows from Linux/macOS Add Windows target:
rustup target add x86_64-pc-windows-gnu
Build for Windows:
cargo build --release --target x86_64-pc-windows-gnu
Output binary:
./target/x86_64-pc-windows-gnu/release/minimal_ai.exe
macOS from Linux/Windows (requires macOS SDK & tooling) Add macOS target:
rustup target add x86_64-apple-darwin
Build for macOS:
cargo build --release --target x86_64-apple-darwin
Output binary:
./target/x86_64-apple-darwin/release/minimal_ai
Note: Cross-compiling to macOS requires additional setup such as osxcross or an actual macOS machine.
📦 Packaging & Installation
Use cargo-deb:
cargo install cargo-deb
[package.metadata.deb]
maintainer = "Your Name <[email protected]>"
cargo build --release
cargo deb --no-build
sudo dpkg -i target/debian/minimal-ai_0.1.0_amd64.deb
sudo ln -s /usr/bin/minimal_ai /usr/local/bin/minimal-ai
Linux (GNOME/KDE/Xfce)
Create a .desktop file so it appears in your application launcher.
Place the executable in a system path (e.g. /usr/bin/minimal_ai — your Debian package does this).
Create ~/.local/share/applications/minimal-ai.desktop with:
ini
Copy
Edit
[Desktop Entry]
Name=Minimal AI
Comment=Fuzzy‑learning CLI assistant
Exec=minimal_ai
Icon=utilities-terminal
Terminal=true
Type=Application
Categories=Utility;
Make it executable:
chmod +x ~/.local/share/applications/minimal-ai.desktop
To uninstall
sudo dpkg -r minimal-ai
Remove Config Files
sudo dpkg --purge minimal-ai
Use Inno Setup:
Write an installer script installer.iss:
[Setup]
AppName=Minimal AI
AppVersion=0.1
DefaultDirName={pf}\Minimal AI
DefaultGroupName=Minimal AI
OutputBaseFilename=MinimalAIInstaller
Compression=lzma
SolidCompression=yes
[Files]
Source: "target\release\minimal_ai.exe"; DestDir: "{app}"; Flags: ignoreversion
[Icons]
Name: "{group}\Minimal AI"; Filename: "{app}\minimal_ai.exe"
Compile the script with Inno Setup Compiler to generate installer .exe.
macOS .app and .dmg Use cargo-bundle:
cargo install cargo-bundle
cargo build --release
cargo bundle --release
This produces .app and optionally .dmg installers.
💬 Usage Run the app, type teaching mode to teach new knowledge.
Ask questions or input math expressions.
Use commands like show, reset, export_csv, etc.
Ensure espeak (Linux/macOS) or PowerShell (Windows) is available for speech output.