Metadata-Version: 2.4
Name: analogai-foundation
Version: 0.1.253
Summary: AnalogAI Foundation - A foundation framework for AI agents
License: MIT
Author: AnalogAI Team
Requires-Python: >=3.12,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Dist: PyYAML (>=6.0.1,<7.0.0)
Requires-Dist: dynaconf (>=3.2.6,<4.0.0)
Requires-Dist: fastapi (>=0)
Requires-Dist: neo4j (>=5.28.1,<6.0.0)
Requires-Dist: pydantic (>=2.0.0,<3.0.0)
Requires-Dist: pymongo (>=4.11.3,<5.0.0)
Requires-Dist: python-dotenv (>=1.0.0,<2.0.0)
Requires-Dist: python-jose (>=3.3.0,<4.0.0)
Requires-Dist: sentence-transformers (>=4.0.2,<5.0.0)
Requires-Dist: spacy (>=3.7.0,<4.0.0)
Requires-Dist: typeguard (>=4.4.2,<5.0.0)
Requires-Dist: tzlocal (>=5.3.1,<6.0.0)
Description-Content-Type: text/markdown

# AnalogAI Foundation

A comprehensive Python package for building AI agent systems with advanced capabilities including emotional intelligence, inference mechanisms, and multi-database support.

## Installation

Install the package in editable mode:

```bash
pip install -e .
```

Install with development dependencies:

```bash
pip install -e ".[dev]"
```

## Project Structure

```
Foundation/
├── src/
│   └── analogai/
│       └── foundation/
│           ├── common/         # Shared utilities, logging, DTOs, enums
│           ├── core/           # Core domain value objects and observables
│           ├── extensions/     # Auth, authorization, conversation, queries, etc.
│           ├── infrastructure/ # Repositories, storage adapters, services
│           ├── modules/        # Domain modules (beliefs, notions, inference)
│           ├── setup/          # Factories and wiring helpers
│           └── tests/          # Functional and unit tests
├── pyproject.toml       # Unified package configuration
├── setup.py             # Setup helper
├── MANIFEST.in          # Package manifest
└── README.md
```

## Modules

### Common (`src/analogai/foundation/common/`)
- **Design Patterns**: Chain of responsibility, singleton, state machine
- **Logging**: Application logging utilities
- **Utils**: Serialization, modifiers, lemmatization helpers

### Core (`src/analogai/foundation/core/`)
- **Value Objects**: Time, relation, modifiers, attributes
- **Observables**: Notion and statement observables

### Extensions (`src/analogai/foundation/extensions/`)
- **Authentication / Authorization**: Token & auth services
- **Conversation / Belief Query / Contradictions**: Extension services and adapters

### Infrastructure (`src/analogai/foundation/infrastructure/`)
- **Repositories**: In-memory, MongoDB, Neo4j
- **Storage Adapters**: Vector storage and query adapters
- **Gateways**: Database gateways and services

### Modules (`src/analogai/foundation/modules/`)
- **Belief / Notion / Agent / User**: Domain services and entities
- **Inference**: Categorical & conditional deduction, contradictions

## Requirements

- Python >= 3.12
- See `pyproject.toml` for complete dependency list

## Development

### Running Tests

The project uses Python's built-in `unittest` framework:

```bash
python -m unittest discover -s src -p "test_*.py"
```

### Code Quality

Format code with black:

```bash
black src/
```

Lint with ruff:

```bash
ruff check src/
```

Type check with mypy:

```bash
mypy src/
```

### Coverage

Run coverage report:

```bash
coverage run -m unittest discover -s src -p "test_*.py"
coverage report
coverage html
```

## License

MIT


