Skip to content

Releases: Aryanag2/Alfred

Release list

Alfred v1.0.0

Alfred v1.0.0 Latest
Latest

Choose a tag to compare

View all tags
@Aryanag2 Aryanag2 released this 18 Feb 04:58
v1.0.0
bf90651

Alfred v1.0.0

Alfred is a lightweight macOS menu bar utility that brings AI-powered file management to your fingertips — convert, organize, rename, and summarize files through a clean native UI, all without leaving your desktop.

Installation

  1. Download Alfred.app.zip below
  2. Unzip — you'll see Alfred.app and install.sh side by side
  3. Open Terminal, cd to the unzipped folder, and run: 
    bash install.sh
  4. Alfred is installed to /Applications — double-click to launch

Why the install script? Alfred is not signed with a paid Apple Developer certificate. macOS will show "Alfred is damaged" if you double-click it directly. install.sh removes that restriction in one step with xattr -cr.

What Alfred can do

Feature Description
Convert Images (PNG/JPG/WebP/HEIC), audio (MP3/WAV/FLAC), documents (MD/PDF/DOCX/EPUB), data (JSON/CSV/YAML/XLSX/TOML)
Organize AI-powered folder cleanup — describe what you want in plain English
Rename Renames files based on their content; vision-capable for images
Summarize 3-bullet summary of any text file, PDF, or document
Command Natural language → runs shell/Python code on your files

All conversions use bundled Python libraries — no external tools required for most formats. Install ffmpeg for video/extended audio, pandoc for advanced documents.

AI Providers

Alfred defaults to Ollama (local, private). Switch to any cloud provider by editing cli/.env before building, or drop a .env file into Alfred.app/Contents/Resources/:

Local (free, private):

  • Ollama — ollama pull qwen3:4b (default)

Cloud:

Provider Recommended Model Notes
OpenAI gpt-5-mini Best value GPT-5 ($0.25/$2 per 1M); use gpt-5.2 for flagship
Anthropic claude-sonnet-4-6 Best balance of speed + quality
Google gemini-2.5-pro GA flagship; gemini-3-pro-preview for bleeding-edge (preview)

100+ more providers supported via LiteLLM.

Requirements

  • macOS 13 or later
  • Apple Silicon (M1/M2/M3/M4) — Intel build available by compiling from source
  • For local AI: Ollama + ollama pull qwen3:4b

Build from source

git clone https://github.com/Aryanag2/Alfred.git
cd Alfred
cp cli/.env.example cli/.env   # configure your AI provider
./build.sh
open swift-alfred/Alfred.app

What's new in v1.0.0

  • Initial public release
  • Unified natural-language query input across all modes
  • Dispatch → Confirm/Reject agent flow — Alfred proposes a plan before acting
  • Bundled Python conversion engine (no external tools for most formats)
  • Vision-capable rename and organize (analyzes image content)
  • Self-contained app bundle with embedded Python 3.13 runtime
  • 192 tests, all passing
Assets 3
Loading