Aira: An Intelligent Middle Layer Architecture for Personalized AI Interactions

Aira is an intelligent middle layer between users and AI, designed to solve problems in current large language model interactions such as context loss, inconsistent style, and intent understanding deviations. By building a persistent user semantic model, it enables intent recognition, dynamic routing, personalized prompt construction, and response calibration, making AI interactions more natural and efficient. Its core is to let AI understand users' needs and preferences like a familiar friend.

Existing AI interaction modes have obvious limitations:

1. Repeated background explanation: Need to reintroduce background, preferences, and goals in each new conversation;
2. Inconsistent style: Large differences in response styles between different sessions, lacking continuity;
3. Intent understanding deviation: Easy to misunderstand real intent in complex or multi-step tasks;
4. Context loss: Cross-session historical information cannot be effectively utilized, leading to untargeted suggestions. Aira's core concept is to build a semantic model of the "persistent you" to solve these pain points.

Aira adopts a modular pipeline architecture, with key components including:

• Input Analyzer: Extracts intent, tone, urgency, and topic, using a two-stage design (rule engine → TF-IDF + logistic regression classifier);
• Model Router: Selects backends based on intent and complexity (local/Ollama, cloud fast/Gemini Flash, cloud expert/Claude Sonnet, etc.);
• Prompt Builder: Three-layer architecture (core rules + user profile + dynamic context) to balance general quality and personalization;
• Alignment Engine: Evaluates response relevance, style consistency, and satisfaction, triggering re-generation or calibration;
• Memory Manager: Three layers of memory (session RAM, factual SQLite FTS5, sticky MEMORY.md);
• Goal Engine: Associates conversations with users' long-term goals to provide targeted suggestions.

Multi-Backend Support:

Backend	Type	Enable Method
Gemini 2.0 Flash	Cloud-Free	Set GEMINI_API_KEY
Ollama	Local/Offline	python main.py config set backend ollama
Claude Sonnet	Cloud	ANTHROPIC_API_KEY + pip install anthropic
GPT-4o-mini	Cloud	OPENAI_API_KEY + pip install openai
OpenRouter	Cloud Multi-Model	OPENROUTER_API_KEY + pip install requests

Usage Methods:

• Command-line chat: python main.py chat
• Web interface: python main.py ui (Gradio)
• Memory view: python main.py memory
• Profile view: python main.py profile
• MCP server: python main.py mcp (IDE integration)
• Special commands: !intent <task> to correct intent, quit/exit/bye to end the session.

Aira stores user data in the local ~/.aria/ directory, including:

• profile.db (SQLite database, persistent state)
• config.json (user configuration)
• intent_model.pkl (intent classifier)
• MEMORY.md (user-editable sticky memory)
• Conversation logs, etc. Users have full control over their data and can delete, export, or modify any information.

Technical Highlights:

• Auto-trained intent classifier (based on conversation history, no manual annotation required);
• Three-layer prompt architecture (balances general, personalized, and dynamic context);
• SQLite FTS5 full-text search (efficient semantic memory search);
• Thread-safe storage (RLock ensures multi-thread consistency);
• 33 unit tests (covering 9 suites).

Version Evolution:

• v0.1-v0.3: Basic intent analysis and memory system;
• v0.4-v0.6: Alignment engine, multi-backend routing, web interface;
• v0.7-v0.9: MCP server, SQLite FTS5, goal engine;
• v1.0: Complete audit, integration tests, production-level configuration.

Future Plans: v1.1 (Web search + code execution), v1.2 (Conversation branching + undo), v2.0 (Multi-user support).

Aira represents a new paradigm for personalized AI interactions, solving core pain points of current large language models through an intelligent middle layer. Its modular architecture supports independent evolution, the three-layer memory balances performance and persistence, multi-backend provides flexibility, and MCP integration opens up possibilities for tool integration. For users who frequently collaborate with AI, Aira is a personalized solution worth trying, and it is expected to drive more innovative interaction modes in the future.