Advanced AI-Powered Coding Assistant with Multi-Provider Support
GerdsenAI Socrates is a powerful AI-enhanced development assistant that combines multiple AI providers (OpenAI, Anthropic, Ollama), intelligent code analysis, document management (RAG), and web search capabilities into a seamless desktop application with IDE integration.
Built with Tauri, React, and Rust, it provides a modern, performant interface for AI-assisted coding with advanced features like deep analysis mode, context window management, and extensible MCP integration.
- Seamlessly switch between OpenAI GPT, Anthropic Claude, and Ollama models
- Smart model routing based on task capabilities
- Real-time cost and performance tracking
- Intelligent provider fallback
- AI-powered LSP: Intelligent code analysis, error detection, and suggestions
- Smart completions: Context-aware code completions
- Intelligent hover: AI explanations for code elements
- Deep analysis mode: Socratic questioning for complex problem-solving
- Upload and manage technical documentation
- Retrieval-Augmented Generation for context-aware responses
- Collection management with metadata
- Semantic search with relevance scoring
- Built-in SearXNG with health monitoring
- Real-time internet search toggle
- Visual status indicators with automatic failover
- Modern dark/light theme support
- Real-time health monitoring for all services
- Smooth animations and responsive design
- Multi-window desktop application support
- MCP (Model Context Protocol) support for custom integrations
- Built-in core services (Ollama, SearXNG, ChromaDB, LSP)
- Popular tools quick-add gallery
- Plugin-ready architecture
Windows:
# Right-click and "Run as Administrator"
install-wrapper.batmacOS/Linux:
chmod +x install-symlink.sh
./install-symlink.shFor detailed installation instructions, see the Installation Guide.
- Ensure Ollama is installed and running
- Launch GerdsenAI Socrates from Start Menu (Windows) or Applications (macOS)
- Select an AI model from the dropdown
- Start chatting with your AI coding assistant!
- Quick Start Guide - Get started in minutes
- Installation Guide - Comprehensive installation instructions
- User Manual - Complete feature guide
- Troubleshooting - Common issues and solutions
- Contributing Guidelines - How to contribute
- Development Setup - Setting up your dev environment
- TypeScript Patterns - Code patterns and best practices
- Architecture Overview - System architecture
- Windows Setup - Windows configuration
- macOS Setup - macOS configuration
- Context Window Management - Token management system
- Deep Analysis Mode - Socratic questioning engine
- MCP Integration - Extensibility framework
- SearXNG Setup - Web search configuration
📖 Complete Documentation Index
- OS: Windows 10/11, macOS 10.15+, or Linux (Ubuntu 20.04+)
- CPU: 4-core processor
- RAM: 8GB (16GB recommended)
- Storage: 5GB free space
- Network: Internet connection for downloads
- Ollama: For AI model functionality (download)
- Node.js 20+: For development
- Rust: For building from source
- Docker: For SearXNG web search
- VS Code or Visual Studio: For IDE integration
GerdsenAI Socrates includes comprehensive production-ready testing infrastructure:
- 24/24 tests passing for ChatInterface (100% coverage)
- Full Tauri command mocking
- Complete user workflow testing
- 70+ comprehensive Rust tests across critical modules
- HTTP mocking for external APIs
- Concurrency and performance testing
# Frontend tests
npm test
# Backend tests
cd src-tauri && cargo test
# Full test suite
./scripts/test.sh# Install dependencies
npm install
# Start development server (Vite)
npm run dev
# Start Tauri development mode
npm run tauri:dev
# Build frontend
npm run build
# Build Tauri application
npm run tauri build
# Run linter
npm run lint
# Format code
npm run format
# Run quality checks
npm run qualityGerdsenAI_AutoCoder/
├── src/ # React frontend source
├── src-tauri/ # Rust backend source
├── docs/ # Documentation
├── scripts/ # Build and utility scripts
├── extensions/ # IDE extensions
├── docker/ # Docker configurations
└── public/ # Static assets
This project follows an Inquiry-Based Learning approach:
- Question First: Understand the 'why' before the 'how'
- Challenge Assumptions: Verify what we think we know
- Explore Alternatives: Consider multiple solutions
- Learn Continuously: Every bug is a learning opportunity
See Contributing Guidelines for detailed development practices.
We welcome contributions! Please see our Contributing Guidelines for:
- Development setup
- Code style guidelines
- Testing requirements
- Pull request process
- Community guidelines
The repository has been reorganized for better maintainability:
- Documentation moved to
/docswith logical subdirectories - Scripts organized in
/scriptswith platform-specific folders - Backward compatibility maintained through wrappers and symlinks
Migration Guide - For updating references and bookmarks
Copyright © 2025 GerdsenAI. All rights reserved.
See LICENSE file for details.
- Documentation: /docs
- Issue Tracker: GitHub Issues
- Ollama: https://ollama.ai
- Discord: Join our community (coming soon)
- Documentation: Check the docs folder
- Troubleshooting: See Troubleshooting Guide
- Issues: Report bugs on GitHub Issues
- Community: Join discussions on GitHub
Happy coding with GerdsenAI Socrates! 🚀
An AI-powered development assistant that enhances your coding workflow