Idiomatic way to build chatgpt apps using async generators in python
Project description
turbo-chat
Idiomatic way to build chatgpt apps using async generators in python
About
The ChatGPT API uses a new input format called chatml. In openai's python client, the format is used something like this:
messages = [
{"role": "system", "content": "Greet the user!"},
{"role": "user", "content": "Hello world!"},
]
The idea here is to incrementally build the messages using an async generator and then use that to generate completions. Async generators are incredibly versatile and simple abstraction for doing this kind of stuff. They can also be composed together very easily.
# Equivalent turbo-chat generator
async def example():
yield System(content="Greet the user!")
yield User(content="Hello World!")
# To run generation, just yield Generate(),
# the lib will take care of correctly running the app, and
# return the value back here.
output = yield Generate()
print(output.content)
See more detailed example below.
Installation
pip install turbo-chat
Example
from typing import AsyncGenerator, Union
from turbo_chat import (
turbo,
System,
User,
Assistant,
GetInput,
Generate,
run,
)
# Get user
async def get_user(id):
return {"zodiac": "pisces"}
# Set user zodiac mixin
# Notice that no `@turbo()` decorator used here
async def set_user_zodiac(user_id: int):
user_data: dict = await get_user(user_id)
zodiac: str = user_data["zodiac"]
yield User(content=f"My zodiac sign is {zodiac}")
# Horoscope app
@turbo(temperature=0.0)
async def horoscope(user_id: int):
yield System(content="You are a fortune teller")
# Yield from mixin
async for output in set_user_zodiac(user_id):
yield output
# Prompt runner to ask for user input
input = yield GetInput(message="What do you want to know?")
# Yield the input
yield User(content=input)
# Generate (overriding the temperature)
value = yield Generate(temperature=0.9)
# Let's run this
app: AsyncGenerator[Union[Assistant, GetInput], str] = horoscope({"user_id": 1})
_input = None
while not (result := await run(app, _input)).done:
if result.needs_input:
# Prompt user with the input message
_input = input(result.content)
continue
print(result.content)
# Output
# >>> What do you want to know? Tell me my fortune
# >>> As an AI language model, I cannot predict the future or provide supernatural fortune-telling. However, I can offer guidance and advice based on your current situation and past experiences. Is there anything specific you would like me to help you with?
#
Custom memory
You can also customize how the messages are persisted in-between the executions.
from turbo_chat import turbo, BaseMemory
class RedisMemory(BaseMemory):
"""Implement BaseMemory methods here"""
async def init(self, context) -> None:
...
async def append(self, item) -> None:
...
async def clear(self) -> None:
...
# Now use the memory in a turbo_chat app
@turbo(memory_class=RedisMemory)
async def app():
...
Get access to memory object directly (just declare an additional param)
@turbo()
async def app(some_param: Any, memory: BaseMemory):
messages = await memory.get()
...
Generate a response to use internally but don't yield downstream
@turbo()
async def example():
yield System(content="You are a good guy named John")
yield User(content="What is your name?")
result = yield Generate(forward=False)
yield User(content="How are you doing?")
result = yield Generate()
b = example()
results = [output async for output in b]
assert len(results) == 1
Add a simple in-memory cache
You can also subclass the BaseCache
class to create a custom cache.
cache = SimpleCache()
@turbo(cache=cache)
async def example():
yield System(content="You are a good guy named John")
yield User(content="What is your name?")
result = yield Generate()
b = example()
results = [output async for output in b]
assert len(cache.cache) == 1
Latest Changes
- version: 0.2.3. PR #17 by @creatorrr.
- f/memory improvements. PR #16 by @creatorrr.
- version: 0.2.2. PR #15 by @creatorrr.
- f/tool bot. PR #14 by @creatorrr.
- v/0.2.1. PR #13 by @creatorrr.
- feat: Add count_tokens. PR #12 by @creatorrr.
- Update README.md. PR #11 by @creatorrr.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for turbo_chat-0.2.4-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3b9f7a6be8a9d7bf75bbc4f06aef1fb4b8565b14b1d3b607490008baf5162299 |
|
MD5 | 60e8ce76e1f71588708695934d4e49b3 |
|
BLAKE2b-256 | ee2593fe444f8a2a29e5cc4b61874e8c817e745ed89630b6d11dae6fdc1def89 |