Contributing

# Clone and setup
git clone https://github.com/bikidsx/remina
cd remina
python -m venv .venv
source .venv/bin/activate  # Linux/macOS
pip install -e ".[all,dev]"
 
# Start infrastructure
docker-compose up -d
 
# Run tests
pytest

remina/
├── remina/
│   ├── __init__.py
│   ├── cache.py
│   ├── exceptions.py
│   ├── models.py
│   ├── configs/
│   ├── embeddings/
│   ├── llms/
│   ├── memory/
│   ├── storage/
│   ├── vector_stores/
│   └── utils/
├── examples/
├── tests/
├── docs/
├── pyproject.toml
└── docker-compose.yml

# remina/storage/dynamodb.py
from remina.storage.base import StorageBase
from remina.models import Memory
from typing import List, Dict, Any, Optional
 
class DynamoDBStorage(StorageBase):
    def __init__(self, config: Optional[Dict[str, Any]] = None):
        super().__init__(config)
        # Initialize client
        
    async def save(self, memories: List[Memory]) -> None:
        pass
    
    async def get(self, ids: List[str]) -> List[Memory]:
        return []
    
    # Implement remaining methods

# remina/utils/factory.py
class StorageFactory:
    provider_map = {
        "dynamodb": "remina.storage.dynamodb.DynamoDBStorage",
    }

# remina/configs/storage.py
class DynamoDBConfig(BaseModel):
    table_name: str = Field("remina_memories")
    region: str = Field("us-east-1")

# tests/test_storage_dynamodb.py
import pytest
from remina.storage.dynamodb import DynamoDBStorage
 
@pytest.mark.asyncio
async def test_dynamodb_save():
    storage = DynamoDBStorage({"table_name": "test"})
    # Test implementation

# Format
black remina/
 
# Lint
ruff check remina/

def search(
    self,
    query: str,
    user_id: str,
    limit: int = 10,
    filters: Optional[Dict[str, Any]] = None,
) -> Dict[str, Any]:
    ...

def add(
    self,
    messages: Union[str, List[Dict[str, str]]],
    user_id: str,
    metadata: Optional[Dict[str, Any]] = None,
) -> Dict[str, Any]:
    """
    Extract and store memories from messages.
    
    Args:
        messages: Text string or list of message dicts
        user_id: User identifier
        metadata: Optional metadata to attach
        
    Returns:
        Dict with 'results' containing added memories
        
    Raises:
        LLMError: If fact extraction fails
        StorageError: If saving fails
    """

# All tests
pytest
 
# With coverage
pytest --cov=remina
 
# Specific file
pytest tests/test_memory.py
 
# Unit tests only
pytest -m "not integration"