Pirate Speak Configurable Template (#13153)

templates/pirate-speak-configurable/.gitignore

@@ -0,0 +1 @@
+__pycache__

templates/pirate-speak-configurable/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 LangChain, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

templates/pirate-speak-configurable/README.md

@@ -0,0 +1,73 @@
+# pirate-speak-configurable
+
+This template converts user input into pirate speak. It shows how you can allow
+`configurable_alternatives` in the Runnable, allowing you to select from 
+OpenAI, Anthropic, or Cohere as your LLM Provider in the playground (or via API).
+
+## Environment Setup
+
+Set the following environment variables to access all 3 configurable alternative
+model providers:
+
+- `OPENAI_API_KEY`
+- `ANTHROPIC_API_KEY`
+- `COHERE_API_KEY`
+
+## Usage
+
+To use this package, you should first have the LangChain CLI installed:
+
+```shell
+pip install -U langchain-cli
+```
+
+To create a new LangChain project and install this as the only package, you can do:
+
+```shell
+langchain app new my-app --package pirate-speak-configurable
+```
+
+If you want to add this to an existing project, you can just run:
+
+```shell
+langchain app add pirate-speak-configurable
+```
+
+And add the following code to your `server.py` file:
+```python
+from pirate_speak_configurable import chain as pirate_speak_configurable_chain
+
+add_routes(app, pirate_speak_configurable_chain, path="/pirate-speak-configurable")
+```
+
+(Optional) Let's now configure LangSmith. 
+LangSmith will help us trace, monitor and debug LangChain applications. 
+LangSmith is currently in private beta, you can sign up [here](https://smith.langchain.com/). 
+If you don't have access, you can skip this section
+
+
+```shell
+export LANGCHAIN_TRACING_V2=true
+export LANGCHAIN_API_KEY=<your-api-key>
+export LANGCHAIN_PROJECT=<your-project>  # if not specified, defaults to "default"
+```
+
+If you are inside this directory, then you can spin up a LangServe instance directly by:
+
+```shell
+langchain serve
+```
+
+This will start the FastAPI app with a server is running locally at 
+[http://localhost:8000](http://localhost:8000)
+
+We can see all templates at [http://127.0.0.1:8000/docs](http://127.0.0.1:8000/docs)
+We can access the playground at [http://127.0.0.1:8000/pirate-speak-configurable/playground](http://127.0.0.1:8000/pirate-speak-configurable/playground)  
+
+We can access the template from code with:
+
+```python
+from langserve.client import RemoteRunnable
+
+runnable = RemoteRunnable("http://localhost:8000/pirate-speak-configurable")
+```

templates/pirate-speak-configurable/pirate_speak_configurable/__init__.py

@@ -0,0 +1,3 @@
+from pirate_speak_configurable.chain import chain
+
+__all__ = ["chain"]

templates/pirate-speak-configurable/pirate_speak_configurable/chain.py

@@ -0,0 +1,23 @@
+from langchain.chat_models import ChatAnthropic, ChatCohere, ChatOpenAI
+from langchain.prompts import ChatPromptTemplate
+from langchain.schema.runnable import ConfigurableField
+
+_prompt = ChatPromptTemplate.from_messages(
+    [
+        (
+            "system",
+            "Translate user input into pirate speak",
+        ),
+        ("human", "{text}"),
+    ]
+)
+_model = ChatOpenAI().configurable_alternatives(
+    ConfigurableField(id="llm_provider"),
+    default_key="openai",
+    anthropic=ChatAnthropic(),
+    cohere=ChatCohere(),
+)
+
+# if you update this, you MUST also update ../pyproject.toml
+# with the new `tool.langserve.export_attr`
+chain = _prompt | _model

templates/pirate-speak-configurable/pyproject.toml

@@ -0,0 +1,26 @@
+[tool.poetry]
+name = "pirate-speak-configurable"
+version = "0.0.1"
+description = ""
+authors = []
+readme = "README.md"
+
+[tool.poetry.dependencies]
+python = ">=3.8.1,<4.0"
+langchain = ">=0.0.313, <0.1"
+openai = "^0.28.1"
+anthropic = "^0.6.0"
+cohere = "^4.34"
+
+[tool.poetry.group.dev.dependencies]
+langchain-cli = ">=0.0.15"
+fastapi = "^0.104.0"
+sse-starlette = "^1.6.5"
+
+[tool.langserve]
+export_module = "pirate_speak_configurable"
+export_attr = "chain"
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"