Vote Clarify

A package for processing user queries about why small voting or ranking projects get flagged as spam so easily.

Overview

This package uses natural language processing to understand the input and generates a structured response with insights and potential solutions. It leverages the capabilities of llmatch-messages to ensure the response is consistent and formatted correctly, making it easier for users to understand the issue and find solutions.

Installation

pip install voteclarify

Usage

fromvoteclarifyimportvoteclarifyuser_input="My small voting project gets flagged as spam, why?"response=voteclarify(user_input)
print(response)

You can pass additional parameters to customize the behavior:

fromvoteclarifyimportvoteclarifyfromlangchain_core.language_modelsimportBaseChatModelfromlangchain_core.messagesimportHumanMessage, SystemMessagefromlangchain_llm7importChatLLM7fromlangchain_openaiimportChatOpenAIuser_input="My small voting project gets flagged as spam, why?"llm=ChatOpenAI()
response=voteclarify(user_input, llm=llm)
print(response)

You can also use your own LLM instance, for example:

fromvoteclarifyimportvoteclarifyfromlangchain_openaiimportChatOpenAIuser_input="My small voting project gets flagged as spam, why?"llm=ChatOpenAI()
response=voteclarify(user_input, llm=llm)
print(response)

Or use the Anthropic or Google Generative AI:

fromvoteclarifyimportvoteclarifyfromlangchain_anthropicimportChatAnthropicfromlangchain_google_genaiimportChatGoogleGenerativeAIuser_input="My small voting project gets flagged as spam, why?"llm=ChatAnthropic()
response=voteclarify(user_input, llm=llm)
print(response)

API Key

The default rate limits for LLM7 free tier are sufficient for most use cases of this package. If you need higher rate limits, you can pass your own API key via environment variable LLM7_API_KEY or via passing it directly:

fromvoteclarifyimportvoteclarifyuser_input="My small voting project gets flagged as spam, why?"response=voteclarify(user_input, api_key="your_api_key")
print(response)

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

Limitations

This package is designed to handle common issues with small voting or ranking projects. However, it is not a substitute for professional moderation or review. Always review the output carefully and take necessary actions to ensure the integrity and security of your project.

Contributing

Feel free to contribute to this package by submitting pull requests or opening issues on the GitHub page.

Author

Eugene Evstafev (hi@eugene.plus)