Package: declarai
Documentation 📖:https://declarai.comSource Code 💻:https://github.com/vendi-ai/declaraiWhat is Declarai 🤔?Declaraiturns your Python code into LLM tasks, allowing you to easily integrate LLM into your existing codebase.
It operates on a simple principle: just define a Python function/class.
By annotating this function with docstrings and type hints, you provide a clear instruction set for the AI model without any additional effort.Once you've declared your function, Declarai intelligently compiles the function's docstrings and type hints into a prompt for the AI model, ensuring the model understands exactly what's required.After executing the task, Declarai retrieves the AI's response and parses it, translating it back into the declared return type of your Python function. This eliminates any manual parsing or post-processing on your part.DeclaraiKeeps It Native: At its core, Declarai is about embracing native Python practices. You don't need to learn a new syntax or adapt to a different coding paradigm. Just write Python functions as you always have, and let Declarai handle the AI integration seamlessly.Main Components 🧩Tasks 💡AI tasks are used for any business logic or transformation.importdeclaraigpt_35=declarai.openai(model="gpt-3.5-turbo")@gpt_35.taskdefrank_by_severity(message:str)->int:"""Rank the severity of the provided message by it's urgency.Urgency is ranked on a scale of 1-5, with 5 being the most urgent.:param message: The message to rank:return: The urgency of the message"""rank_by_severity(message="The server is down!")>>>5rank_by_severity(message="How was your weekend?"))>>>1Chat 🗣AI Chats are used for an iterative conversation with the AI model, where the AI model can remember previous messages and context.importdeclaraigpt_35=declarai.openai(model="gpt-3.5-turbo")@gpt_35.experimental.chatclassSQLBot:"""You are a sql assistant. You help with SQL related questions"""sql_bot=SQLBot()sql_bot.send("When should I use a LEFT JOIN?")>"You should use a LEFT JOIN when you want to return all rows from ....Features:🖍Intelligent Prompts: Automatically generate prompts using type hints and docstrings.🚄Conversational AI: Chat interface equipped with memory and context management.⚡Real-time streaming: Stream LLM responses that take longer to complete.🔥Pydantic Model Parsing: Seamlessly parse llm responses intoPydantic models.🐍Pythonic: Native understanding and parsing of llm responses intoPython primitives.💾Multiple AI Backends: Integrated with OpenAI & Azure AI llm providers.🛠Middleware: Adapt and extend tasks behavior with a modular middleware system.🤗Coming Soon: Integration with HuggingFace hubQuickstart 🚀InstallationpipinstalldeclaraiSetupexportOPENAI_API_KEY=<youropenaitoken>or pass the token when initializing the declarai objectimportdeclaraigpt_35=declarai.openai(model="gpt-3.5-turbo",openai_token="<your-openai-key>")💡 Basic UsageCraft AI-powered functionalities with ease using the@taskdecorator. Just add some type hints and a bit of documentation, and watch Declarai do its magic!importdeclaraigpt_35=declarai.openai(model="gpt-3.5-turbo")@gpt_35.taskdefgenerate_poem(title:str)->str:"""Write a 4 line poem on the provided title"""res=generate_poem(title="Declarai, the declarative AI framework for LLMs")print(res)# Declarai, the AI framework,# Empowers LLMs with declarative power,# Efficiently transforming data and knowledge,# Unlocking insights in every hour.Not the best poem out there, but hey! You've written your first declarative AI code!Declarai aims to promote clean and readable code by enforcing the use of doc-strings and typing.
The resulting code is readable and easily maintainable.Tasks with python native output parsingPython primitivesimportdeclaraigpt_35=declarai.openai(model="gpt-3.5-turbo")@gpt_35.taskdefrank_by_severity(message:str)->int:"""Rank the severity of the provided message by it's urgency.Urgency is ranked on a scale of 1-5, with 5 being the most urgent.:param message: The message to rank:return: The urgency of the message"""rank_by_severity(message="The server is down!")>>>5rank_by_severity(message="How was your weekend?"))>>>1Python Lists/Dicts etc..fromtypingimportListimportdeclaraigpt_35=declarai.openai(model="gpt-3.5-turbo")@gpt_35.taskdefmulti_value_extraction(text:str)->List[str]:"""Extract the phone numbers from the provided text:param text: content to extract phone number from:return: The phone numbers that where identified in the input text"""multi_value_extraction(text="Hey jenny,\nyou can call me at 124-3435-132.\n""you can also reach me at +43-938-243-223")>>>['124-3435-132','+43-938-243-223']Python complex objectsfromdatetimeimportdatetimeimportdeclaraigpt_35=declarai.openai(model="gpt-3.5-turbo")@gpt_35.taskdefdatetime_parser(raw_date:str)->datetime:"""Parse the input into a valid datetime string of the format YYYY-mm-ddThh:mm:ss:param raw_date: The provided raw date:return: The parsed datetime output"""datetime_parser(raw_date="Janury 1st 2020"))>>>2020-01-0100:00:00Pydantic modelsfrompydanticimportBaseModelfromtypingimportList,DictimportdeclaraiclassAnimal(BaseModel):name:strfamily:strleg_count:intgpt_35=declarai.openai(model="gpt-3.5-turbo")@gpt_35.taskdefsuggest_animals(location:str)->Dict[int,List[Animal]]:"""Create a list of numbers from 0 to 5for each number, suggest a list of animals with that number of legs:param location: The location where the animals can be found:return: A list of animal leg count and for each count, the corresponding animals"""suggest_animals(location="jungle")>>>{0:[Animal(name='snake',family='reptile',leg_count=0)],2:[Animal(name='monkey',family='mammal',leg_count=2),Animal(name='parrot',family='bird',leg_count=2)],4:[Animal(name='tiger',family='mammal',leg_count=4),Animal(name='elephant',family='mammal',leg_count=4)]}Jinja templates 🥷importdeclaraigpt_35=declarai.openai(model="gpt-3.5-turbo")@gpt_35.taskdefsentiment_classification(string:str,examples:List[str,int])->int:"""Classify the sentiment of the provided string, based on the provided examples.The sentiment is ranked on a scale of 1-5, with 5 being the most positive.{% for example in examples %}{{ example[0] }} // {{ example[1] }}{% endfor %}{{ string }} //"""sentiment_classification(string="I love this product but there are some annoying bugs",examples=[["I love this product",5],["I hate this product",1]])>>>4Simple Chat interfaceimportdeclaraigpt_35=declarai.openai(model="gpt-3.5-turbo")@gpt_35.experimental.chatclassCalculatorBot:"""You a calculator bot,given a request, you will return the result of the calculation"""defsend(self,message:str)->int:...calc_bot=CalculatorBot()calc_bot.send(message="1 + 1")>>>2📚 For a thorough introduction, features, and best practices, explore ourofficial documentationandbeginner's guide.Contributing 💼Join our mission to make declarative AI even better together! Check out ourcontributing guideto get started.