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

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