Skip to main content

notifex

PyPI version License: MIT Downloads LinkedIn

notifex is a Python package designed to help developers extract and structure notification content from iOS and Android devices for use with ClaudeCode. The package takes raw notification text as input and returns a standardized, machine-readable format, making it easier to consistently process and analyze notifications across different platforms.

Installation

pip install notifex

Usage

Basic Usage

from notifex import notifex

# Example with default LLM (ChatLLM7)
response = notifex("New message from John: Are we still meeting tomorrow?")
print(response)

Custom LLM

You can use any LLM that's compatible with LangChain by passing a custom LLM instance:

Using OpenAI

from langchain_openai import ChatOpenAI
from notifex import notifex

llm = ChatOpenAI()
response = notifex("New message from John: Are we still meeting tomorrow?", llm=llm)

Using Anthropic

from langchain_anthropic import ChatAnthropic
from notifex import notifex

llm = ChatAnthropic()
response = notifex("New message from John: Are we still meeting tomorrow?", llm=llm)

Using Google

from langchain_google_genai import ChatGoogleGenerativeAI
from notifex import notifex

llm = ChatGoogleGenerativeAI()
response = notifex("New message from John: Are we still meeting tomorrow?", llm=llm)

API Key Configuration

By default, notifex uses ChatLLM7 with its free tier. If you need higher rate limits, you can provide your own API key:

# Via parameter
response = notifex("Your notification text", api_key="your_llm7_api_key")

# Via environment variable
import os
os.environ["LLM7_API_KEY"] = "your_llm7_api_key"
response = notifex("Your notification text")

You can get a free API key by registering at https://token.llm7.io/

Parameters

  • user_input (str): The notification text to process
  • llm (Optional[BaseChatModel]): The LangChain LLM instance to use. If not provided, ChatLLM7 is used by default.
  • api_key (Optional[str]): The API key for LLM7. If not provided, it checks the environment variable LLM7_API_KEY.

Contributing

Found a bug or have a feature request? Please open an issue at https://github.com/chigwell/notifex/issues.

Author

Eugene Evstafev - hi@euegne.plus

Metadata

Release files for notifex 2025.12.21125243

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for notifex 2025.12.21125243
File Size Uploaded
notifex-2025.12.21125243.tar.gz 5.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for notifex 2025.12.21125243
File Interpreter ABI Platform
notifex-2025.12.21125243-py3-none-any.whl Python 3 none any Details

Total release size: 12.4 kB

Release files / notifex-2025.12.21125243.tar.gz

Download URL notifex-2025.12.21125243.tar.gz
Size 5.9 kB
Tags Source
SHA-256 checksum
How to use checksums
ee634da5e43daacaf69c9a3df1730de2f5755e7724c6bc41abefdd4ed392d7d5
BLAKE2b-256 checksum
How to use checksums
66b95a2c75732bd3001c349c453b67cad6d45e9b25375e94d7144ee287c8ffd3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.1

Release files / notifex-2025.12.21125243-py3-none-any.whl

Download URL notifex-2025.12.21125243-py3-none-any.whl
Size 6.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a0bfc4fbba11092c68ae0767cede9c8b40e321a844f13e1c3258639491698f7f
BLAKE2b-256 checksum
How to use checksums
c65a6e0a51684e945acbc62a884bc7a995615feb9f9f65c85a4f1f6f9e38f804
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.1

Release history Release notifications | RSS feed

This release

2025.12.21125243 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page