Skip to main content

Encrypted reminders, scheduling, tags, SSE and MCP.

Project description

Oremi Isinmi

Buy me a beer

Oremi Isinmi is the reminders, scheduling, tags, and notification subsystem for the Oremi personal assistant project. It uses FastAPI, Pydantic, SQLCipher-encrypted SQLite, Server-Sent Events, and Pydantic-AI with Ollama as the default backend.

The name "Oremi Isinmi" comes from two Yorùbá words: Oremi, meaning "my friend", and Isinmi, meaning "rest" or "appointment". Together, the name conveys the idea of a friendly assistant that helps you manage your time and commitments efficiently, bringing calm and order to your daily life.

Oremi Isinmi Logo

Documentation

Find the Oremi Isinmi deployment and API documentation at https://demsking.gitlab.io/oremi-isinmi.

Core Capabilities

  • Intelligent Reminder Management: Create, update, and track reminders with natural language
  • Smart Event Scheduling: Plan events with automatic reminder generation
  • Tag-Based Organization: Filter and find items instantly using custom tags
  • Real-time Notifications: SSE streaming for immediate updates
  • AI Conversation: Chat with the agent to manage your schedule
  • Encrypted Storage: All data secured with SQLCipher
  • Lightweight Deployment: Alpine-based Docker image for minimal resource usage

Use Cases

  • Personal Time Management: "Remind me to call the dentist tomorrow at 2pm"
  • Event Planning: "Schedule a team meeting for Friday at 10am, tag it as 'work'"
  • Information Retrieval: "Show me all my personal reminders for next week"
  • Tag Organization: "List all events tagged as 'urgent' and 'work'"

Model Context Protocol

The app exposes an MCP HTTP endpoint at /mcp. The available tools are derived from the Reminders, Events, and Notifications API tags. Agent and Health are not exported as MCP tools.

Contribute

Please follow CONTRIBUTING.md.

Versioning

Given a version number MAJOR.MINOR.PATCH, increment the:

  • MAJOR version when you make incompatible API changes,
  • MINOR version when you add functionality in a backwards-compatible manner, and
  • PATCH version when you make backwards-compatible bug fixes.

Additional labels for pre-release and build metadata are available as extensions to the MAJOR.MINOR.PATCH format.

See SemVer.org for more details.

License

Copyright 2026 Sébastien Demanou. All Rights Reserved.

Licensed under the Apache License, Version 2.0. See the LICENSE for the complete license text.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

oremi_isinmi-1.0.0b1-py3-none-any.whl (60.2 kB view details)

Uploaded Python 3

File details

Details for the file oremi_isinmi-1.0.0b1-py3-none-any.whl.

File metadata

  • Download URL: oremi_isinmi-1.0.0b1-py3-none-any.whl
  • Upload date:
  • Size: 60.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.13

File hashes

Hashes for oremi_isinmi-1.0.0b1-py3-none-any.whl
Algorithm Hash digest
SHA256 f2d9e796eaa19b7325e1d2a962126c3e974afbf53bf67d4ff6b5e8fd2a0bd887
MD5 d1fe3ce7bf26cc4ad37ec1ca72fe8e6d
BLAKE2b-256 c88dd0dfcb26aace3ffe89bb02f16c7f025c8481365b2ed75decf9fef234e0f3

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page