Friday — Your Personal AI Agent

Friday is a powerful, autonomous personal AI agent designed to live on your local machine and interact via Telegram. It combines advanced reasoning, long-term memory, and a suite of automation tools to act as a truly capable "Chief of Staff."

🚀 Key Features

🎙️ Voice & Speech

• Local Wake Word: Always-on listener for the "Friday" wake word (custom Picovoice model with Italian language support).
• Voice Transcription: Seamlessly transcribes Telegram voice messages using OpenAI Whisper for natural, hands-free interaction.

🧠 Advanced Memory & Context

• Multimodal Memory: Extracts information from images (GPT-4o Vision), audio (Whisper), and PDFs (pdf-parse) for a comprehensive "Second Brain."
• Long-term Memory: Hybrid storage system using SQLite and Markdown files for persistent data.
• Semantic Search: Integrated with Pinecone for high-dimensional vector search across your shared history.
• Knowledge Graph: Builds a map of entities and relationships to understand your world.
• Auto-Compaction: Periodically summarizes old conversations to maintain focus and efficiency.

🔔 Proactive Intelligence

• Smart Recommendations: Friday analyzes your behavior and history to suggest relevant next steps before you even ask.
• Persistent Interaction: Visual typing indicators during complex processing to provide real-time feedback.

🔧 Automation Toolkit

• 💬 WebChat UI: A premium WebSocket-powered chat interface in Mission Control with markdown rendering and multimodal file uploads.
• 📊 Mission Control Dashboard: A premium Next.js 15 dashboard for monitoring heartbeats, logs, and real-time activities.
• 🤖 Agentic Automations: Native Cron integration with support for complex task instructions. Friday can execute autonomous coding, research, or system maintenance on a schedule.
• ⏰ One-shot Reminders: Simple "notify and delete" tasks with natural voice rephrasing for a warm, human-like experience.
• 🌐 Browser Automation: Fully capable of navigating the web, extracting data, and taking actions.
• 💻 Shell Execution: Executes terminal commands safely to manage your system.
• 📂 File Operations: Read, write, and manage files on your local disk.
• 📡 MCP Bridge: Communicates with any Model Context Protocol server for expanded toolsets.
• 🔍 Web Search: Real-time access to the web for the latest information.
• 🎨 Slash Commands: Enhanced UX via Telegram with /status, /new, /model, /usage, and /models.

🤖 Multi-Agent Architecture

• Swarm Mode: Friday can delegate specialized tasks (coding, research, review) to a swarm of sub-agents.
• Mesh Workflows: Built-in orchestration for complex, multi-step projects.
• Skills System: Dynamically extensible capabilities via the Skills Manager.

🛠️ Setup

Prerequisites

• Node.js (v18+)
• Telegram Bot Token (from @BotFather)
• OpenAI API Key (or ChatGPT Plus for OAuth mode)
• Picovoice AccessKey (for Wake Word detection)

Installation

1. Clone the repository:

   git clone https://github.com/friday-ai-bot-max/custom-friday-agent.git
   cd custom-friday-agent

2. Install dependencies:

   npm install

3. Configure environment:

   cp .env.example .env
   # Edit .env with your keys

4. Build & Start:

   npm run build
   npm run dev

🔒 Privacy & Security

• Local First: Your data stays on your machine.
• White-list Only: Only authorized Telegram User IDs defined in .env can interact with the bot.
• On-Device Wake Word: Voice triggers are processed locally; no audio is sent to the cloud for idle listening.

Built with ❤️ for personal productivity.