Metadata-Version: 2.4
Name: ailocalcore
Version: 0.1.0
Summary: Personality and Context Awareness system for local AI models.
Author: Mehosni
License: MIT
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: ailocalmemory>=0.1.0
Requires-Dist: ailocalconnection>=0.1.1
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"

# AILocalCore 🧠🎭

AILocalCore is the overarching "Brain" library for local AI development. It integrates personality definition, environment awareness, memory management, and internet search into a single, cohesive orchestration layer.

## Dependencies

AILocalCore acts as a wrapper and requires the following libraries:
- `ailocalmemory` (for SQLite-based conversation history and ChatSession)
- `ailocalconnection` (for real-time web browsing and AI Router logic)

## Features

1. **Persona Engine**: Inject dynamic identities and rules. Tell your AI it's a "Sarcastic Genius" or a "Professional Assistant", and give it strict behaviors to follow.
2. **Context Awareness**: The AI automatically knows the current date, time, operating system, and any custom environment variables (like user name, weather, or location).
3. **The Orchestrator (`AIBrain`)**: 
   - Dynamically crafts a hyper-personalized system prompt combining Persona + Context.
   - Saves it to `AILocalMemory` so the local model retains it.
   - Evaluates user queries using `AILocalConnection` (Router) to decide if an internet search is needed.
   - Injects search results transparently into the LLM context.

## Usage

See `example.py` for a complete demonstration of how to hook up `OllamaAdapter`, `ChatSession`, `Persona`, `ContextAwareness`, and `AIBrain`.
