Alfred

Personal assistant for the terminal, for all operating systems and languages

Python OpenAI CLI Multiplatform

Features

Terminal assistant

Ask questions directly from the command line

Powered by GPT

Uses OpenAI models for intelligent responses

Multiplatform

Compatible with Linux, macOS and Windows

Multilanguage

Ask and get answers in any language

Installation

System requirements:

	
		
			< >
			Input
		
		
			Bash
			
		
	
	
		sudo apt update
sudo apt install -y python3 python3-pip git
	
	Copied

Installer (.deb) From source

If you have a Debian-based system, download and install alfred.deb

Install Python dependencies:

	
		
			< >
			Input
		
		
			Bash
			
		
	
	
		pip install halo
pip install --upgrade openai
	
	Copied

Clone the repository:

	
		
			< >
			Input
		
		
			Bash
			
		
	
	
		sudo rm -r /usr/src/alfred
cd /usr/src
git clone -b branch_v1.3 https://github.com/maximofn/alfred.git
cd /usr/src/alfred
sudo find . -depth -not -name '*.py' -delete
	
	Copied

Create an alias and restart the terminal:

	
		
			< >
			Input
		
		
			Bash
			
		
	
	
		echo 'alias alfred="/usr/src/alfred/alfred.py"' >> ~/.bashrc
source ~/.bashrc
	
	Copied

OpenAI API KEY

Go to platform.openai.com/api-keys
Click on "Create new secret key"
Copy the key and paste it when Alfred asks for it

Usage

Direct command Interactive mode

Type alfred followed by your question.

Type alfred, press Enter and keep asking questions. Type exit to quit.

Support

If you like it consider giving the repository a star ⭐, but if you really like it consider buying me a coffee ☕.

Continue reading

How to parse tool calls from OpenAI, Anthropic and Google

How to turn tool calls from different LLM providers into one common interface without losing the identifiers that correlate each result.

How to declare reliable tools for OpenAI, Anthropic and Google

A practical guide to designing tools an LLM can discover, adapting them to any LLM provider, executing them safely, and ...

Gymnasia: architecture of an AI agent that runs on the phone

How the Gymnasia AI agent is built: a BYOK conversational coach with local tools and a food estimator that reads macros ...

Last posts -->

Have you seen these projects?

Gymnasia

LangGraph Deep Researcher

Tau

View all projects -->

>_ Available for projects

Do you have an AI project?

Let's talk.

maximofn@gmail.com

Machine Learning and AI specialist. I develop solutions with generative AI, intelligent agents and custom models.

Write me LinkedIn

Do you want to watch any talk?

Tomorrow's Agents: Deciphering the Mysteries of Planning, UX and Memory

AI agents, powered by LLMs, promise to transform applications. But are they simple executors today or future intelligent collaborators? To reach their...

Create your own Apple intelligence

Learn to create an IA system to execute efficiently on a device

Last talks -->

Do you want to improve with these tips?

Best practices building agents with Claude Code

Technical talk: skills, subagents, slash commands and MCPs in Claude Code

o1 prompt engineering

Create better prompts for o1 following an example

Memory profiler

See the memory usage of a script

Last tips -->

Use this locally

Hugging Face spaces allow us to run models with very simple demos, but what if the demo breaks? Or if the user deletes it? That's why I've created docker containers with some interesting spaces, to be able to use them locally, whatever happens. In fact, if you click on any project view button, it may take you to a space that doesn't work.