---
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
```