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

Autonomous context compression: the agent decides when to forget

I explain LangChain's autonomous context compression: a Deep Agents tool that lets the agent itself decide when to summarize its memory.

The harness is the product: why AI agents fail

I explain nyk's «The Harness Is The Product»: why the harness around the model decides whether an AI agent works in prod...

Qwen Image 2.1 on two RTX 3090s: from a private Studio to ZeroGPU

How I tested Qwen Image 2.1 on two RTX 3090s, built a private Gradio Studio behind Tailscale and ported it to Hugging Fa...

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?

The rice journey: building an agent in a gym and nutrition app

Interactive 3D talk (in Spanish) on the Gymnasia agent: where data lives, from plate to data, tools, duplicates, health limits and how to test it all.

Best practices building agents with Claude Code

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

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.