mirror of
https://github.com/hwchase17/langchain
synced 2024-10-29 17:07:25 +00:00
e5fed7d535
Add more details to the [notebook for StreamlitChatMessageHistory](https://python.langchain.com/docs/integrations/memory/streamlit_chat_message_history), including a link to a [running example app](https://langchain-st-memory.streamlit.app/). Original PR: https://github.com/langchain-ai/langchain/pull/8497
77 lines
3.3 KiB
Markdown
77 lines
3.3 KiB
Markdown
# Streamlit
|
||
|
||
> **[Streamlit](https://streamlit.io/) is a faster way to build and share data apps.**
|
||
> Streamlit turns data scripts into shareable web apps in minutes. All in pure Python. No front‑end experience required.
|
||
> See more examples at [streamlit.io/generative-ai](https://streamlit.io/generative-ai).
|
||
|
||
[](https://codespaces.new/langchain-ai/streamlit-agent?quickstart=1)
|
||
|
||
In this guide we will demonstrate how to use `StreamlitCallbackHandler` to display the thoughts and actions of an agent in an
|
||
interactive Streamlit app. Try it out with the running app below using the [MRKL agent](/docs/modules/agents/how_to/mrkl/):
|
||
|
||
<iframe loading="lazy" src="https://langchain-mrkl.streamlit.app/?embed=true&embed_options=light_theme"
|
||
style={{ width: 100 + '%', border: 'none', marginBottom: 1 + 'rem', height: 600 }}
|
||
allow="camera;clipboard-read;clipboard-write;"
|
||
></iframe>
|
||
|
||
## Installation and Setup
|
||
|
||
```bash
|
||
pip install langchain streamlit
|
||
```
|
||
|
||
You can run `streamlit hello` to load a sample app and validate your install succeeded. See full instructions in Streamlit's
|
||
[Getting started documentation](https://docs.streamlit.io/library/get-started).
|
||
|
||
## Display thoughts and actions
|
||
|
||
To create a `StreamlitCallbackHandler`, you just need to provide a parent container to render the output.
|
||
|
||
```python
|
||
from langchain.callbacks import StreamlitCallbackHandler
|
||
import streamlit as st
|
||
|
||
st_callback = StreamlitCallbackHandler(st.container())
|
||
```
|
||
|
||
Additional keyword arguments to customize the display behavior are described in the
|
||
[API reference](https://api.python.langchain.com/en/latest/callbacks/langchain.callbacks.streamlit.streamlit_callback_handler.StreamlitCallbackHandler.html).
|
||
|
||
### Scenario 1: Using an Agent with Tools
|
||
|
||
The primary supported use case today is visualizing the actions of an Agent with Tools (or Agent Executor). You can create an
|
||
agent in your Streamlit app and simply pass the `StreamlitCallbackHandler` to `agent.run()` in order to visualize the
|
||
thoughts and actions live in your app.
|
||
|
||
```python
|
||
from langchain.llms import OpenAI
|
||
from langchain.agents import AgentType, initialize_agent, load_tools
|
||
from langchain.callbacks import StreamlitCallbackHandler
|
||
import streamlit as st
|
||
|
||
llm = OpenAI(temperature=0, streaming=True)
|
||
tools = load_tools(["ddg-search"])
|
||
agent = initialize_agent(
|
||
tools, llm, agent=AgentType.ZERO_SHOT_REACT_DESCRIPTION, verbose=True
|
||
)
|
||
|
||
if prompt := st.chat_input():
|
||
st.chat_message("user").write(prompt)
|
||
with st.chat_message("assistant"):
|
||
st_callback = StreamlitCallbackHandler(st.container())
|
||
response = agent.run(prompt, callbacks=[st_callback])
|
||
st.write(response)
|
||
```
|
||
|
||
**Note:** You will need to set `OPENAI_API_KEY` for the above app code to run successfully.
|
||
The easiest way to do this is via [Streamlit secrets.toml](https://docs.streamlit.io/library/advanced-features/secrets-management),
|
||
or any other local ENV management tool.
|
||
|
||
### Additional scenarios
|
||
|
||
Currently `StreamlitCallbackHandler` is geared towards use with a LangChain Agent Executor. Support for additional agent types,
|
||
use directly with Chains, etc will be added in the future.
|
||
|
||
You may also be interested in using
|
||
[StreamlitChatMessageHistory](/docs/integrations/memory/streamlit_chat_message_history) for LangChain.
|