ReciMCP

Lightweight Python project for working with recipes and favourites (service-style layout).

This repository contains application code under src/ grouped into app/, core/, and libs/ modules.

Key ideas

• src/app — application wiring, API surface and configuration

• src/core — business logic (commands, interfaces, queries)

• src/libs — infrastructure code (persistence, external clients)

Requirements

• Python 3.11+ (project bytecode indicates 3.12 compatibility; 3.11+ recommended)

Quickstart

1. Create and activate a virtual environment (macOS / zsh):

python -m venv .venv
source .venv/bin/activate

2. Install dependencies

• If you use Poetry:

poetry install

• Otherwise, if there is a requirements.txt or you prefer pip editable install:

pip install -r requirements.txt  # if present
# or
pip install -e .

Run the application

• Run the main script (quick run):

python src/main.py

Testing

• Run tests with pytest:

pytest -q

Development notes

• The repository uses a src/ layout. Keep package imports relative to src (e.g. from app import ...).

• Common files/directories to ignore are already included in .gitignore (virtualenvs, bytecode, editor folders, etc.).

Project structure (high level)

src/
  main.py         # entry point
  app/            # API, config, DI container
  core/           # domain logic and interfaces
  libs/           # infra (clients, repositories)

Contributing

• Please open an issue for feature requests or bugs, and submit pull requests with a clear description.

• Add unit tests for new behavior and keep changes small.

License & Contact

• Add your preferred license file (e.g. LICENSE) if you plan to open-source this project.

• For questions, contact the repository owner or maintainers.