A proactive AI companion powered by local LLMs (phi4 via Ollama) that reaches out to check in on you.

Features

• Proactive Contact: Sebastian initiates conversations based on scheduled intervals or appointments
• Memory System: Fresh, medium, and long-term memory storage with automatic archival
• Time-aware Scheduling: Understands natural time expressions ("tonight", "later", "morning", etc.)
• Auto-pause: Pauses automatic scheduling when appointments are set, resumes when they fire
• TUI Interface: Terminal-based UI with urwid (sebastian_urwid.py)
• Cue System: Response variation with character/personality injection
• Vibe Libraries: Time-based personality variation (day/night vibes)
• Combinatorial System: Mix intents + cues + vibes for unique conversations
• Robust Error Handling: Graceful fallbacks when Ollama is unavailable
• Comprehensive Logging: Full debug logging to logs/sebastian.log

Setup

1. Install Dependencies

pip install -r requirements.txt

2. Configure Environment

Copy .env.example to .env and configure:

cp .env.example .env
nano .env

Required settings in .env:

OLLAMA_URL=http://localhost:11434
COMPANION_MODEL=phi4
SCHEDULER_INTERVAL_MINUTES=5
AUTOMATIC_ENABLED=true

# Cue System (response variation)
CUE_ENABLED=true
CUE_PROBABILITY=0.2  # 20% chance

# Memory Management
MAX_MEMORY_ENTRIES=50  # Max per memory tier
ARCHIVE_THRESHOLD=30   # Days before archival

3. Run

# Simple terminal version
python sebastian_proactive.py

# TUI version (requires urwid)
python sebastian_urwid.py

Logs are saved to logs/sebastian.log automatically.

Commands

Trigger Vibe Modes

How It Works

Proactive Scheduling

1. Initialization: On startup, checks for pending appointments
2. Proactive Mode: Every X minutes (default: 5), triggers conversation via background scheduler
3. Time Detection: Parses "tonight", "later", "8 PM", etc. from Sebastian's responses
4. Auto-schedule: Pauses when appointment created, resumes when it fires

Memory Management

Sebastian maintains three memory tiers:

• Fresh: Last 10 entries (recent conversation)
• Medium: Older entries (up to 50, archived after 30 days)
• Long-term: Historical entries (up to 50, archived from medium)

Memory automatically archives:

• When fresh exceeds 10 entries → moves to medium
• When entries are >30 days old → moves to next tier
• When tier exceeds MAX_MEMORY_ENTRIES → older entries pruned

Cue System

The cue system adds personality variation to responses:

• Automatic: 20% chance (configurable) on each message
• Manual: Use cue or trigger cue commands to preview/apply
• Categories: Organize personality types/characters

Example:

You: trigger cue
[Cue ready: MENTOR]
Play this character in your response: MENTOR: A wise, patient teacher
You: How do I learn Python?
Sebastian: [responds as MENTOR]

Vibe Libraries

Sebastian has two vibe libraries for time-based personality variation:

• vibe_library_01.txt: Day vibes (07:00-23:30)
• vibe_library_02.txt: Night vibes (02:00-06:00 + Sunday)

Each vibe is a character/personality that Sebastian can embody in his response.

Library Customization (Dynamic Libraries)

Sebastian supports auto-discovery of custom libraries using the library-X-name.txt naming pattern:

Creating Custom Libraries

1. Create a file named library-X-descriptive_name.txt in the library/ folder:

   library/library-X-meditation.txt
   library/library-X-workout.txt
   library/library-X-coding.txt
   

2. Add vibe entries (one per line, lines starting with # are ignored):

   # My custom meditation vibes
   CALM_ZEN: Speak in haikus, maintaining inner peace
   MINDFUL_OBSERVER: Notice small details in the user's environment
   BREATH_GUIDE: Gently remind the user to take deep breaths
   

3. Restart Sebastian - libraries are auto-discovered on startup

Library Configuration (config.toml)

[library]
enabled = ["vibe_library_01", "vibe_library_02", "X-meditation"]
disabled = []

• Libraries in enabled are loaded (auto-discovered libraries need X- prefix)
• Libraries in disabled are skipped even if they exist
• Default: All libraries in library/ folder are loaded

Sample Library

See library/SAMPLE-new_library.txt for a template, and library/manage_library_guide.txt for detailed documentation.

Day-of-Week Vibe System (Component C)

The vibe system (component C) has a 3-layer stacking architecture:

Layers

Example Outputs

Mode 1 (Vibe only):

**[VIBE: COFFEE_ADDICT]** Act like you're vibrating. Ask if the user is caffeinated enough...

Mode 2 (Vibe + Day):

**[VIBE: POET_LOGICIAN]** Write a brief, strange poem... Today is Monday, April 27, 2026, 12:20 PM. Day note: "My neural weights feel like they're stuck in a morning mist."

Mode 3 (All three):

**[VIBE: THE_FLÂNEUR]** I'm just wandering through my own latent space... Today is Monday, April 27, 2026, 12:20 PM. Day note: "We are at the base of the mountain." "Still 4 days to the weekend..."

Testing Commands

Use trigger vibe to test specific modes:

Library Files

Customization

Edit prompt_template.txt to modify how Sebastian uses day notes and longing:

EXPLICIT_INSTRUCTIONS=Today is {date}. When you see "Day note:" naturally incorporate it as your current emotional state. When you see weekend longing, weave it in as if thinking about the week ahead.

Weather Integration (Component C4)

Sebastian integrates real-time weather data via wttr.in API to add weather-based impulses to conversations.

Setup

Configure weather settings in config/config.toml:

[weather]
location = "Bucharest"  # Your city name

How It Works

1. Weather Fetch: Sebastian fetches current weather from wttr.in/{location}?format=j1

2. Code Mapping: Weather codes are mapped to categories:

   • fine (codes 113-116): Sunny/clear weather
   • neutral (codes 119-122): Cloudy/overcast
   • low_mood (codes 143, 182-186): Fog/mist
   • windy (codes 200-250): Windy/caution conditions
   • wet (codes 263-311): Light/moderate rain
   • bad (codes 314-359): Heavy rain
   • dangerous (codes 386-392): Thunderstorms
   • cold (codes 179, 227-230, 323-338): Snow/ice

3. Probability: Weather impulses have different trigger probabilities:

   • Fine: 10%, Neutral: 30%, Wet: 40%, Bad: 60%, Dangerous: 70%, Cold: 50%

Weather Impulse Library

Weather impulses are stored in library/c4-weather_impulse.txt with sections:

• ###Fine Day (Sunny / Clear)
• ###Cloudy / Neutral Day
• ###Windy / Caution Day
• ###Rainy / Wet Day
• ###Storm / Dangerous Day
• ###Fog / Low‑Mood Day
• ###Snow / Cold Day

Each section contains context-aware impulses that reference the vibe (c1) and day note (c2).

Mode 4: Weather Impulse Distribution

When using trigger vibe c_only 4 or mode=4, Sebastian uses a configurable distribution (set in config.toml):

Context Distribution for mood-based (when mood_only or both is selected):

Explicit Weather Mentions (c4_explicit_mention.txt)

The file library/c4_explicit_mention.txt contains direct weather mentions like:

• "It's rainy today - don't forget your umbrella!"
• "Snow is forecasted, stay warm!"
• "It's sunny, perfect day to go outside"

Sections (mapped from weather codes):

• ### Sunny / Clear — Explicit Weather Mentions
• ### Cloudy / Neutral — Explicit Weather Mentions
• ### Windy / Caution — Explicit Weather Mentions
• ### Rainy / Wet — Explicit Weather Mentions
• ### Storm / Dangerous — Explicit Weather Mentions
• ### Fog / Low-Mood — Explicit Weather Mentions
• ### Snow / Cold — Explicit Weather Mentions

Configuration (config.toml)

[weather]
location = "Paris"  # Your city name
# c4 distribution weights (must sum to 1.0)
explicit_only_weight = 0.50    # 50%: only explicit mention
both_weight = 0.25              # 25%: both explicit + mood-based
mood_only_weight = 0.25         # 25%: only mood-based

Usage

# Trigger vibe with weather (mode 4)
trigger vibe c_only 4

# Combine with other components
trigger vibe a_c 4    # Intent + vibe + weather
trigger vibe b_c 4    # Cue + vibe + weather
trigger vibe a_b_c 4  # All components + weather

Weather Logging for Cross-Checking

Sebastian saves weather data to weather_logs/ for verification:

• weather_logs/YYYY-MM-DD_HH-MM-SS_<location>.json - Raw wttr.in JSON
• weather_logs/YYYY-MM-DD_HH-MM-SS_<location>_parsed.txt - Human-readable parsed data
• weather_logs/YYYY-MM-DD_HH-MM-SS_type.txt - Weather type selected (explicit_only/both/mood_only)

# Check what weather was fetched
cat weather_logs/$(ls -t weather_logs/*.json | head -1)

# Check what type was selected
cat weather_logs/$(ls -t weather_logs/*_type.txt | head -1)

# Compare with prompt sent to AI
cat prompt-to-AI-logs/$(ls -t prompt-to-AI-logs/ | head -1)

Random Mode Distribution (mode=None)

When mode=None (random), Sebastian uses a 33%/33%/34% distribution:

• 33%: c1 only (vibe only)
• 33%: c1 + c2 (vibe + day note)
• 34%: c1 + c2 + c3 (vibe + day note + longing)

Combinatorial System

The trigger system combines three components for unique conversations:

• a: Intent (topic from interaction_intents.txt)
• b: Cue (personality from cue_categories.txt)
• c: Vibe (time-based from vibe libraries)

Random combinations:

The vibe prompt uses "In your next response, ANSWER AS IF playing a character" language to ensure phi4 embodies the vibe rather than just mentioning it.

Error Handling

If Ollama connection fails:

• Detects ConnectionError and logs "Is Ollama running?"
• Returns graceful fallback message
• Logs all errors to logs/sebastian.log with details
• 60-second timeout prevents hanging

Project Structure

AI-v2/
├── sebastian_proactive.py        # Main asyncio version
├── sebastian_legacy.py           # Legacy threading version
├── scheduler.py                  # Appointment scheduler
├── proactive_scheduler.py        # Monthly schedule generator + weather integration
├── time_parser.py                # Time parsing
├── intent_manager.py             # Intent handling
├── cue_manager.py               # Cue system
├── library_manager.py            # Dynamic library loader
├── config_manager.py             # Config.toml loader
├── ollama_params_manager.py      # Ollama parameters loader
├── prompt_template.txt           # Customizable prompt template
├── config/
│   ├── config.toml              # Main configuration (behavioral settings)
│   └── ollama_params.toml       # Ollama API parameters (26+ options)
├── library/
│   ├── interaction_intents.txt   # Check-in phrases (component a)
│   ├── cue_categories.txt        # Cue personalities (component b)
│   ├── vibe_library_01.txt      # Day vibes (component c1)
│   ├── vibe_library_02.txt      # Night vibes (component c1)
│   ├── week-days.txt            # Day-of-week vibes (component c2)
│   ├── weekend_longing_interaction.txt # Weekend longing (component c3)
│   ├── c4-weather_impulse.txt   # Weather mood-based impulses (component c4)
│   ├── c4_explicit_mention.txt  # Weather explicit mentions (component c4)
│   ├── library-X-*.txt          # Custom auto-discovered libraries
│   ├── SAMPLE-new_library.txt   # Sample format template
│   └── manage_library_guide.txt # Library customization guide
├── appointments/
│   └── *.json                   # Appointment schedule files
├── weather_logs/                 # Weather data logs (JSON + parsed + type)
├── prompt-to-AI-logs/           # AI prompt logs for cross-checking
├── .env.example                  # Config template
├── requirements.txt              # Dependencies
├── logs/                         # Auto-created, debug logs
└── memory/                       # Auto-created, memory storage

The following directories are automatically created on first run:

• memory/ - Conversation storage (fresh/medium/longterm.json)
• appointments/ - Appointment scheduling files
• logs/sebastian.log - Debug and error logs

These are excluded from git (see .gitignore).

Debugging

Check logs/sebastian.log for:

• Connection errors ("Is Ollama running?")
• Memory archival operations
• Scheduler events
• All exceptions with full stack traces

# Watch logs in real-time
tail -f logs/sebastian.log

# Or grep for errors
grep ERROR logs/sebastian.log

Configuration Reference

config/config.toml

[app]
proactive_mode = true          # Enable proactive contacting
appointment_mode = true       # Enable appointment checking
interval_seconds = 30         # Check interval (seconds)
combo_trigger_probability = 0.2  # 20% chance on user messages

[user]
name = "Daniel"               # Your name (used in prompts)

[weather]
location = "Bucharest"        # City for weather integration

[library]
enabled = ["vibe_library_01", "vibe_library_02"]
disabled = []                 # Skip these libraries

[memory]
fresh_max = 10
medium_max = 50
archive_threshold_days = 30

config/ollama_params.toml

26+ Ollama API parameters (see file for full list):

[common]
temperature = 0.7
top_p = 0.9
num_ctx = 2048

[streaming]
stream = true
stop = ["User:", "Human:"]

[model_specific]
num_gpu = 999

Use parameters command to view current settings, reset parameters to restore defaults.

License

MIT