# ifai
**Repository Path**: peterfei_1109/ifai
## Basic Information
- **Project Name**: ifai
- **Description**: 若爱 (IfAI) - 基于 Tauri 2.0 构建的跨平台 AI 代码编辑器 | A Cross-Platform AI Code Editor Built with Tauri 2.0
- **Primary Language**: TypeScript
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 2
- **Created**: 2025-12-30
- **Last Updated**: 2026-03-07
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# IfAI - AI Code Editor
**A Cross-Platform AI Code Editor Built with Tauri 2.0**
[简体中文](./README.md) | English
[](https://opensource.org/licenses/MIT)
[](https://tauri.app/)
[](https://reactjs.org/)
[](https://www.typescriptlang.org/)
[](https://www.rust-lang.org/)
---
## 📖 Introduction
**IfAI (若爱)** is a modern cross-platform code editor that perfectly integrates powerful AI assistance with traditional code editing. The name "若爱" (IfAI) means "if there is love, code will be warm" - we believe AI should be the most caring programming companion for developers.
### 📈 Project Status
- **🎉 v0.2.0 Major Update** - Dec 20, 2025 (Interactivity & Performance Milestone)
- **🎉 v0.1.2 Stable** - Dec 19, 2025
- **⚡ Rendering** - 120 FPS High Frame Rate + GPU Acceleration
- **🌊 Interaction** - Claude-style progressive streaming
- **💾 Memory Usage** - ~80MB (20% lower than v0.1.0)
---
## ✨ v0.2.0 Interaction & Performance Revolution
### 🌊 Claude-style Streaming System
- **Typewriter Effect** - AI tool operations present a smooth line-by-line generation effect.
- **Progressive Parsing** - The Rust backend features heuristic parsing, extracting code content before the response ends.
- **Streaming Cursor Feedback** - Added a dynamic pulsing cursor to tool previews for real-time visual confirmation.
### 🚀 GPU Hardware Acceleration Pipeline
- **120 FPS Support** - Optimized rendering for high-refresh-rate monitors, ensuring ultra-smooth scrolls and animations.
- **Zero-Lag Generation** - 150ms rendering throttling and dynamic scaling eliminate editor lag during AI generation.
- **Performance Monitor** - Toggle a real-time FPS panel with `Mod+Alt+p`.
### ⌨️ Advanced UX & Keyboard Navigation
- **Persistent Command History** - Call back your previous prompts with the **Up Arrow**, even after restarting the app. Experience terminal-like input efficiency.
- **Seamless Global Control** - Re-engineered keyboard logic for Slash Commands and Project Search, supporting smooth up/down navigation and instant selection.
- **Intelligent Indexing** - Precisely distinguishes between manual edits and history refills, ensuring continuous interaction remains intuitive.
### 🛡️ Smart Agent Monitor
- **Drag & Snap** - The monitor widget can be dragged anywhere and intelligently snaps to corners.
- **Adaptive Layout** - The panel automatically adjusts its expansion direction based on its snap position.
- **Full Internationalization** - Task status and real-time logs fully support EN/CN switching.
### 📐 Intelligent Rendering Logic
- **Summary at Bottom** - Re-engineered the engine so tool boxes stay on top, while the AI **Summary** naturally lands at the bottom.
- **Pure UI Upgrade** - Minimalist logo design to maximize space for code communication.
### 🎨 Modern Editor
- **Monaco Editor Core** - Same editor engine as VSCode
- **Syntax Highlighting** - Support for mainstream programming languages
- **Code Intelligence** - Auto-completion, code navigation, refactoring
- **Multi-Tab** - Efficiently manage multiple files
- **File Tree** - Intuitive project structure browsing
- **Theme Customization** - Dark/Light themes, eye-friendly
### 🤖 AI Assistant
- **Multi-Model Support** - OpenAI, Anthropic Claude, Zhipu AI, and other mainstream LLMs
- **Context Understanding** - RAG retrieval enhancement for precise project code comprehension
- **Code Generation** - Generate code from natural language descriptions
- **Smart Refactoring** - AI-assisted code optimization and refactoring
- **Bug Diagnosis** - Intelligent error analysis with fix suggestions
- **Technical Q&A** - Instant answers to programming questions
### 🛠 Development Tools Integration
- **Integrated Terminal** - Built-in terminal for seamless command execution
- **Git Integration** - File status tracking, visual version control
- **LSP Support** - Language Server Protocol for intelligent code analysis
- **Quick Search** - Global file and content search
- **Multi-Language Support** - English/Chinese interface switching
---
## 🏗 Technical Architecture
### Tech Stack
```
┌─────────────────────────────────────────────────────┐
│ IfAI │
├─────────────────────────────────────────────────────┤
│ Frontend Layer │
│ ├─ React 19 - UI Framework │
│ ├─ TypeScript 5.8 - Type Safety │
│ ├─ Zustand - State Management │
│ ├─ TailwindCSS - Styling System │
│ ├─ Monaco Editor - Code Editor │
│ └─ Vite - Build Tool │
├─────────────────────────────────────────────────────┤
│ Backend Layer (Rust/Tauri) │
│ ├─ Tauri 2.0 - Cross-Platform Framework │
│ ├─ tokio - Async Runtime │
│ ├─ serde - Serialization │
│ ├─ reqwest - HTTP Client │
│ ├─ git2 - Git Integration │
│ ├─ portable-pty - Terminal Emulation │
│ └─ walkdir - File Traversal │
├─────────────────────────────────────────────────────┤
│ Core Capability Layer (Private Extension) │
│ ├─ AI Model Integration - Multi-model adapters │
│ ├─ Agent Toolchain - Smart code operations │
│ ├─ RAG Retrieval - Vector semantic search │
│ └─ Context Building - Intelligent understanding │
└─────────────────────────────────────────────────────┘
```
### Core Design
- **Tauri Architecture** - Web frontend + Rust backend, combining performance with development efficiency
- **Event-Driven** - Async communication between frontend and backend through event system
- **Dependency Injection** - Core package accesses main app state through registry mechanism
- **Plugin Design** - Core AI capabilities as independent packages, easy to extend
- **Local-First** - File operations and Git management all performed locally
### Project Structure
```
ifainew/
├── src/ # React frontend code
│ ├── components/ # UI components
│ │ ├── Editor/ # Monaco editor
│ │ ├── FileTree/ # File tree
│ │ ├── AIChat/ # AI chat interface
│ │ └── Terminal/ # Terminal emulator
│ ├── stores/ # Zustand state management
│ │ ├── fileStore.ts # File state
│ │ ├── chatStore.ts # AI chat state
│ │ └── settingsStore.ts # Settings state
│ └── utils/ # Utility functions
│
├── src-tauri/ # Rust backend code
│ ├── src/
│ │ ├── lib.rs # Main entry
│ │ ├── file_walker.rs # File traversal
│ │ ├── terminal.rs # Terminal management
│ │ ├── git.rs # Git integration
│ │ ├── lsp.rs # LSP client
│ │ └── search.rs # File search
│ └── Cargo.toml
│
├── tests/ # Test cases
│ ├── spec_agent_flow.cjs
│ ├── spec_escape_fix.cjs
│ └── spec_tool_history.cjs
│
└── package.json
```
---
## 🚀 Quick Start
### Prerequisites
Ensure the following tools are installed:
- **Node.js** >= 18.0
- **Rust** >= 1.70 (install via [rustup](https://rustup.rs/))
- **System Dependencies**:
- **Windows**: Visual Studio Build Tools
- **macOS**: Xcode Command Line Tools
- **Linux**: `build-essential`, `libgtk-3-dev`, `libwebkit2gtk-4.0-dev`
### Installation Steps
1. **Clone Repository**
```bash
git clone https://github.com/peterfei/ifai.git
cd ifai
```
2. **Install Dependencies**
```bash
npm install
```
3. **Start Development Server**
```bash
npm run tauri dev
```
The app will automatically compile and start, usually within seconds.
### Build Release Version
```bash
# Build frontend
npm run build
# Build Tauri app
npm run tauri build
```
Build artifacts are located in `src-tauri/target/release/bundle/`.
---
## 📸 Screenshots
### Main Interface - Code Editing & File Management
*Monaco Editor + File Tree + Multi-Tab, Smooth Development Experience*
---
### AI Assistant - Code Generation & Conversation
*Multi-model support, streaming responses, Markdown rendering, code highlighting*
---
### Integrated Terminal - Seamless Command Execution
*Built-in terminal emulator, multi-session management, ANSI escape sequences*
---
## 🛠 Development Guide
### Local Development
```bash
# Start development mode
npm run tauri dev
# Run frontend dev server only
npm run dev
# Run tests
node tests/spec_agent_flow.cjs
```
### Code Standards
- **Frontend**: Use TypeScript strict mode, follow React Hooks best practices
- **Backend**: Follow Rust official code standards, run `cargo fmt` and `cargo clippy`
- **Commits**: Follow Conventional Commits specification
### Tech Stack Rationale
**Why Tauri?**
- Excellent performance: Fast startup, low memory (90% less than Electron)
- Secure & reliable: Rust memory safety prevents common vulnerabilities
- Cross-platform: Write once, run everywhere
- Small bundle size: 5-10MB release packages (vs Electron's 100MB+)
**Why React 19?**
- Latest features: React Server Components, concurrent rendering
- Rich ecosystem: Abundant component libraries and tooling
- Developer experience: Hot reload, DevTools, TypeScript support
---
## 🗺 Roadmap
### v0.2.0 (Current) - Interaction Milestone
- ✅ **Claude-style Streaming** - Progressive JSON parsing and typewriter rendering
- ✅ **Smart Agent Monitor** - Draggable, corner-snapping, and adaptive layout
- ✅ **Personalized Settings** - Fira Code, ligatures, smooth caret, and VS Code-style options
- ✅ **Rendering Optimization** - Ensures summary text always lands at the message bottom
- ✅ **Minimalist UI** - Clean chat header and optimized visual space
### v0.3.0 (Planned) - Intelligence Upgrade
- 📋 AI code review
- 📋 Smart test generation
- 📋 Performance analysis tools
- 📋 Team collaboration features
- 📋 Cloud settings sync
### v1.0.0 (Vision) - Production-Ready
- 📋 Enterprise features
- 📋 Private deployment solution
- 📋 Extension marketplace
- 📋 Real-time collaboration
- 📋 Complete debugger integration
---
## 🌟 Future Vision
### Technical Vision
**IfAI** is committed to becoming the smartest programming companion for developers:
1. **AI-Native Editor** - Not simple AI feature stacking, but AI thinking integrated from the ground up
2. **Local-First** - Fully offline capable, protecting code privacy
3. **Open Ecosystem** - Open-source core framework, community-driven plugins and extensions
4. **Cross-Platform Experience** - Unified operation experience, seamless environment switching
### Product Vision
We hope **IfAI** can:
- 🎯 **Lower Programming Barriers** - Enable beginners to quickly get started with AI assistance
- 💡 **Boost Development Efficiency** - Reduce repetitive work, focus on creative tasks
- 🤝 **Facilitate Knowledge Transfer** - AI assistant as code knowledge carrier
- 🌍 **Serve Global Developers** - Multi-language support, adapt to different cultures
### Community Vision
- **Open-Source Collaboration** - Open core framework, welcome code and ideas
- **Knowledge Sharing** - Build developer community, share best practices
- **Continuous Innovation** - Keep up with AI tech evolution, explore new possibilities
---
## 🤝 Contributing
We welcome all forms of contribution!
### How to Contribute
1. **Fork this repository**
2. **Create feature branch** (`git checkout -b feature/AmazingFeature`)
3. **Commit changes** (`git commit -m 'Add some AmazingFeature'`)
4. **Push to branch** (`git push origin feature/AmazingFeature`)
5. **Submit Pull Request**
For detailed contribution guide, see [CONTRIBUTING.md](./CONTRIBUTING.md).
### Ways to Participate
- 🐛 **Report Bugs** - Submit detailed issue reports
- 💡 **Feature Suggestions** - Share your ideas and needs
- 📝 **Improve Documentation** - Enhance docs and examples
- 💻 **Contribute Code** - Fix bugs or add features
- 🌍 **Translation** - Help translate to other languages
---
## 📄 License
This project is licensed under **MIT License**.
Core AI capabilities are provided by proprietary commercial modules and are not included in the open-source scope. The open-source portion provides a complete editor framework and extension interfaces.
See [LICENSE](./LICENSE) file for details.
---
## 💬 Community & Support
- **GitHub Issues**: [Bug Reports](https://github.com/peterfei/ifai/issues)
- **GitHub Discussions**: [Discussions](https://github.com/peterfei/ifai/discussions)
- **Project Homepage**: [https://github.com/peterfei/ifai](https://github.com/peterfei/ifai)
---
## 🙏 Acknowledgments
Thanks to the following open-source projects:
- [Tauri](https://tauri.app/) - Cross-platform framework
- [Monaco Editor](https://microsoft.github.io/monaco-editor/) - Code editor
- [React](https://reactjs.org/) - UI framework
- [Rust](https://www.rust-lang.org/) - System programming language
And all developers who have contributed to this project! ❤️
---
**If this project helps you, please give us a ⭐️**
Made with ❤️ by [peterfei](https://github.com/peterfei)