239242e2fc
- Reorganize project structure and file locations - Add ReasoningController to manage model selection and reasoning mode - Update design and requirements for reasoning mode toggle - Implement model switching between Qwen3-4B-Instruct and Qwen3-4B-Thinking models - Remove deprecated files and consolidate project layout - Add new steering and specification documentation - Clean up and remove unnecessary files and directories - Prepare for enhanced AI sidebar functionality with more flexible model handling
64 lines
1.7 KiB
Markdown
64 lines
1.7 KiB
Markdown
---
|
|
inclusion: always
|
|
---
|
|
|
|
# Technology Stack
|
|
|
|
## Framework & Environment
|
|
|
|
- **Platform**: Ignis desktop environment (Python-based GTK4 framework)
|
|
- **Python Version**: 3.10+
|
|
- **UI Framework**: GTK4 via Ignis widgets
|
|
- **Async/Threading**: GLib for main loop, Python threading for background tasks
|
|
|
|
## Key Dependencies
|
|
|
|
- `ignis` - Desktop environment framework providing widgets and window management
|
|
- `ollama` - Python package for Ollama API integration
|
|
- GTK4 (`gi.repository.GLib`) - UI toolkit and event loop
|
|
|
|
## Architecture Patterns
|
|
|
|
### Widget System
|
|
- Uses Ignis widget abstractions (`widgets.Box`, `widgets.RevealerWindow`, etc.)
|
|
- Material Design 3 styling via CSS classes
|
|
- Revealer-based slide animations
|
|
|
|
### API Communication
|
|
- Direct HTTP calls to Ollama REST API (no external HTTP library)
|
|
- Uses `urllib.request` for HTTP operations
|
|
- Timeout handling: 2s for health checks, 5s for model lists, 120s for chat
|
|
|
|
### State Management
|
|
- Conversation persistence via JSON files
|
|
- Atomic file writes using `tempfile` and `os.replace()`
|
|
- In-memory caching for model lists
|
|
|
|
### Threading Model
|
|
- UI operations on GLib main thread
|
|
- AI requests in background daemon threads
|
|
- `GLib.idle_add()` for thread-safe UI updates
|
|
|
|
### Error Handling
|
|
- Graceful degradation when Ollama is unavailable
|
|
- Availability monitoring with 30-second polling interval
|
|
- User-facing error messages instead of exceptions
|
|
|
|
## Common Commands
|
|
|
|
Since this is an Ignis module, there are no build/test commands. The module is loaded directly by Ignis:
|
|
|
|
```bash
|
|
# Reload Ignis to apply changes
|
|
ignis reload
|
|
|
|
# Run Ignis with console output for debugging
|
|
ignis
|
|
|
|
# Check Ollama status
|
|
curl http://127.0.0.1:11434/api/tags
|
|
|
|
# List installed Ollama models
|
|
ollama list
|
|
```
|