Zinochka

!Zinochka - Project Mascot

A personal AI-enabled assistant that integrates with Plaud note pin using Zapier.

Description

Zinochka listens for webhook calls from Zapier with transcripts from Plaud notes, detects activation phrases, extracts tasks using OpenAI agents, and creates them in TickTick using MCP.

Setup with Docker

1. Set your configuration in the .env file:

cp .env.example .env
# Edit .env file with your API keys and domain configuration

2. Start the application using Docker Compose:

./start.sh

HTTPS Support

The application includes Traefik as a reverse proxy to provide HTTPS for the webhook endpoint:

• Configure your domain in the .env file (WEBHOOK_DOMAIN variable)
• Provide your email for Let's Encrypt certificate notifications (EMAIL variable)
• Traefik will automatically handle SSL certificate generation and renewal using Let's Encrypt

SSL Certificate Troubleshooting

If you encounter issues with SSL certificates:

1. To reset Let's Encrypt certificates and start fresh:

   ./start.sh --reset-certs
   

2. To verify certificates are being obtained correctly:

   docker compose logs -f traefik
   

3. Ensure port 80 and 443 are open and accessible from the internet for Let's Encrypt verification

Manual Setup

1. Install dependencies:

uv pip install -e ".[dev]"

2. Run tests:

pytest

3. Start RabbitMQ:

# Using Docker
docker run -d --name rabbitmq -p 5672:5672 -p 15672:15672 rabbitmq:management

4. Run the Celery worker:

celery -A zinochka.services.celery_app worker --loglevel=info

5. Run the server:

uvicorn zinochka.api.main:app --reload

Architecture

• FastAPI webhook endpoint receiving data from Zapier
• RabbitMQ + Celery for asynchronous task processing
• Activation phrase detection ("зиночка" or "zinochka")
• Task extraction using OpenAI agents
• TickTick integration via MCP with stdio transport
• Orchestration agent to coordinate task extraction and TickTick integration

API Endpoints

• GET /: Health check endpoint
• POST /webhook: Webhook endpoint for receiving transcripts