jules/README.md

# Jules

Jules is a cross-platform AI secretary with memory. It connects to Telegram and email as a single persona — remembers facts, sets reminders, messages contacts, and nudges toward better habits.

## How it works

Every chat implements a minimal interface (`Send` / `Receive`). The engine pulls messages, loads full user context from PostgreSQL (facts, contacts, notifications, recent actions), builds a structured prompt with DeepSeek, parses the response into typed actions, validates them, and executes. If the LLM makes a mistake, the error is fed back into the next prompt so it self-corrects — retry loop with context propagation.

## Stack

Go, PostgreSQL, DeepSeek (reasoner model), Telegram API, Email SMTP daemon, production-grade test coverage (100% across all core packages).

## Quick start

```bash
cp .env.example .env    # fill in your tokens
docker compose up -d    # postgres
go run cmd/jules/main.go
```