| Name | gwenflow JSON |
| Version |
0.5.2
JSON |
| download |
| home_page | None |
| Summary | A framework for orchestrating applications powered by autonomous AI agents and LLMs. |
| upload_time | 2025-01-13 15:11:09 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.11 |
| license | None |
| keywords |
gwenflow
gwenlake
agents
llms
ai
ml
nlp
framework
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
<div align="center">
**A framework for orchestrating applications powered by autonomous AI agents and LLMs.**
[](https://opensource.org/licenses/MIT)
[](https://github.com/your-username/gwenflow/releases)
</div>
## Why Gwenflow?
Gwenflow, a framework designed by [Gwenlake](https://gwenlake.com),
streamlines the creation of customized, production-ready applications built around Agents and
Large Language Models (LLMs). It provides developers with the tools necessary
to integrate LLMs and Agents, enabling efficient and
scalable solutions tailored to specific business or user needs.
## Installation
Install from PyPI:
```bash
pip install gwenflow
```
Install from the main branch to try the newest features:
```bash
# install from Github
pip install -U git+https://github.com/gwenlake/gwenflow.git@main
```
## Usage
Load your OpenAI api key from an environment variable:
```python
import os
from gwenflow import ChatOpenAI
llm = ChatOpenAI(
api_key=os.environ.get("OPENAI_API_KEY"), # This is the default and can be omitted
)
```
or load your api key from a local .env file:
```python
import os
import dotenv
from gwenflow import ChatOpenAI
dotenv.load_dotenv(override=True) # load you api key from .env
llm = ChatOpenAI()
```
## Chat
```python
import os
from gwenflow import ChatOpenAI
dotenv.load_dotenv(override=True) # load you api key from .env
messages = [
{
"role": "user",
"content": "Describe Argentina in one sentence."
}
]
llm = ChatOpenAI(model="gpt-4o-mini")
print(llm.invoke(messages=messages))
```
## Agent
```python
import os
from gwenflow import Agent
dotenv.load_dotenv(override=True) # load you OpenAI api key from .env
# automatically use gpt-4o-mini for the Agent
agent = Agent(
name="Agent",
role="You are a helpful agent.",
)
response = agent.run("how are you?")
print(response.content)
```
## Agents and Tools
```python
import requests
import json
import dotenv
from gwenflow import ChatOpenAI, Agent, Tool
dotenv.load_dotenv(override=True)
def get_exchange_rate(currency_iso: str) -> str:
"""Get the current exchange rate for a given currency. Currency MUST be in iso format."""
try:
response = requests.get("http://www.floatrates.com/daily/usd.json").json()
data = response[currency_iso.lower()]
return json.dumps(data)
except Exception as e:
print(f"Currency not found: {currency_iso}")
return "Currency not found"
tool_get_exchange_rate = Tool.from_function(get_exchange_rate)
llm = ChatOpenAI(model="gpt-4o-mini")
agent = Agent(
name="AgentFX",
role="Get recent exchange rates data.",
instructions="Answer in one sentence and if there is a date, mention this date.",
llm=llm,
tools=[tool_get_exchange_rate],
)
queries = [
"Find the capital city of France?",
"What's the exchange rate of the Brazilian real?",
"What's the exchange rate of the Euro?",
"What's the exchange rate of the Chine Renminbi?",
"What's the exchange rate of the Chinese Yuan?",
"What's the exchange rate of the Tonga?"
]
for query in queries:
print("")
print("Q:", query)
print("A:", agent.run(query).content)
```
```
Q: Find the capital city of France?
A: The capital city of France is Paris, which is not only the largest city in the country but also a major global center for art, fashion, and culture. Located in the north-central part of France along the Seine River, Paris is renowned for its iconic landmarks such as the Eiffel Tower, the Louvre Museum, and the Notre-Dame Cathedral. The city has a rich history dating back to its founding in the 3rd century BC as a small fishing village, and over the centuries, it has evolved into a vibrant metropolis known for its stylish boulevards, world-class cuisine, and significant historical events. Paris also serves as the political and administrative hub of France, housing key government institutions, including the Élysée Palace, where the French President resides.
Q: What's the exchange rate of the Brazilian real?
A: As of January 10, 2025, the exchange rate for the Brazilian Real (BRL) is approximately 6.0604 BRL to 1 USD, with an inverse rate of about 0.1650 USD for 1 BRL. This means that for every Brazilian Real, you can exchange it for about 16.5 cents in US dollars.
Q: What's the exchange rate of the Euro?
A: As of January 10, 2025, the exchange rate for the Euro (EUR) is approximately 0.9709 against the US Dollar, meaning 1 Euro can be exchanged for about 0.9709 USD; conversely, the inverse rate indicates that 1 USD is equivalent to about 1.0300 Euros.
Q: What's the exchange rate of the Chine Renminbi?
A: As of January 10, 2025, the exchange rate for the Chinese Renminbi (CNY), also known as the Chinese Yuan, is approximately 7.33 CNY per 1 USD. Additionally, the inverse rate indicates that 1 CNY is equivalent to about 0.1364 USD. This rate is important for various financial transactions, including trade, investments, and tourism related to China, reflecting the currency's strength in the global market as observed at 15:55 GMT on the same date.
Q: What's the exchange rate of the Chinese Yuan?
A: As of January 10, 2025, the exchange rate for the Chinese Yuan (CNY) is approximately 7.33 CNY to 1 USD, with an inverse rate of about 0.14 USD for each CNY, reflecting its value in the global market. This data indicates the strength of the yuan against the US dollar, and it is essential for understanding its purchasing power and economic interactions, especially for businesses and individuals engaging in international transactions.
Q: What's the exchange rate of the Tonga?
A: As of January 10, 2025, the current exchange rate for the Tongan paʻanga (ISO code: TOP) is approximately 2.42 TOP per 1 USD, while the inverse rate is around 0.41 USD per 1 TOP. The Tongan paʻanga is denoted by the numeric code 776, and the latest exchange data indicates that the rate was last updated at 15:55:14 GMT on the same day.
```
## Contributing to Gwenflow
We are very open to the community's contributions - be it a quick fix of a typo, or a completely new feature! You don't
need to be a Gwenflow expert to provide meaningful improvements.
Raw data
{
"_id": null,
"home_page": null,
"name": "gwenflow",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "gwenflow, gwenlake, agents, llms, ai, ml, nlp, framework",
"author": null,
"author_email": "Gwenlake <info@gwenlake.com>, Sylvain Barth\u00e9l\u00e9my <sylvain.barthelemy@gwenlake.com>, Guillaume Beguec <guillaume.beguec@gwenlake.com>, Antoine de Parthenay <antoine.departhenay@gwenlake.com>",
"download_url": "https://files.pythonhosted.org/packages/21/19/aea26bd0b466e407d34597c430885571408caa72cdc535857563cda58039/gwenflow-0.5.2.tar.gz",
"platform": null,
"description": "<div align=\"center\">\n\n\n\n**A framework for orchestrating applications powered by autonomous AI agents and LLMs.**\n\n[](https://opensource.org/licenses/MIT)\n[](https://github.com/your-username/gwenflow/releases)\n\n\n</div>\n\n## Why Gwenflow?\n\nGwenflow, a framework designed by [Gwenlake](https://gwenlake.com),\nstreamlines the creation of customized, production-ready applications built around Agents and\nLarge Language Models (LLMs). It provides developers with the tools necessary\nto integrate LLMs and Agents, enabling efficient and\nscalable solutions tailored to specific business or user needs.\n\n## Installation\n\nInstall from PyPI:\n\n```bash\npip install gwenflow\n```\n\nInstall from the main branch to try the newest features:\n\n```bash\n# install from Github\npip install -U git+https://github.com/gwenlake/gwenflow.git@main\n```\n\n## Usage\n\nLoad your OpenAI api key from an environment variable:\n\n```python\nimport os\nfrom gwenflow import ChatOpenAI\n\nllm = ChatOpenAI(\n api_key=os.environ.get(\"OPENAI_API_KEY\"), # This is the default and can be omitted\n)\n```\n\nor load your api key from a local .env file:\n\n```python\nimport os\nimport dotenv\nfrom gwenflow import ChatOpenAI\n\ndotenv.load_dotenv(override=True) # load you api key from .env\n\nllm = ChatOpenAI()\n```\n\n## Chat\n\n```python\nimport os\nfrom gwenflow import ChatOpenAI\n\ndotenv.load_dotenv(override=True) # load you api key from .env\n\nmessages = [\n {\n \"role\": \"user\",\n \"content\": \"Describe Argentina in one sentence.\"\n }\n]\n\nllm = ChatOpenAI(model=\"gpt-4o-mini\")\nprint(llm.invoke(messages=messages))\n```\n\n## Agent\n\n```python\nimport os\nfrom gwenflow import Agent\n\ndotenv.load_dotenv(override=True) # load you OpenAI api key from .env\n\n# automatically use gpt-4o-mini for the Agent\nagent = Agent(\n name=\"Agent\",\n role=\"You are a helpful agent.\",\n)\n\nresponse = agent.run(\"how are you?\")\nprint(response.content)\n```\n\n## Agents and Tools\n\n```python\nimport requests\nimport json\nimport dotenv\n\nfrom gwenflow import ChatOpenAI, Agent, Tool\n\ndotenv.load_dotenv(override=True)\n\n\ndef get_exchange_rate(currency_iso: str) -> str:\n \"\"\"Get the current exchange rate for a given currency. Currency MUST be in iso format.\"\"\"\n try:\n response = requests.get(\"http://www.floatrates.com/daily/usd.json\").json()\n data = response[currency_iso.lower()]\n return json.dumps(data)\n except Exception as e:\n print(f\"Currency not found: {currency_iso}\")\n return \"Currency not found\"\n\n\ntool_get_exchange_rate = Tool.from_function(get_exchange_rate)\n\nllm = ChatOpenAI(model=\"gpt-4o-mini\")\n\nagent = Agent(\n name=\"AgentFX\",\n role=\"Get recent exchange rates data.\",\n instructions=\"Answer in one sentence and if there is a date, mention this date.\",\n llm=llm,\n tools=[tool_get_exchange_rate],\n)\n\nqueries = [\n \"Find the capital city of France?\",\n \"What's the exchange rate of the Brazilian real?\",\n \"What's the exchange rate of the Euro?\",\n \"What's the exchange rate of the Chine Renminbi?\",\n \"What's the exchange rate of the Chinese Yuan?\",\n \"What's the exchange rate of the Tonga?\"\n]\n\nfor query in queries:\n print(\"\")\n print(\"Q:\", query)\n print(\"A:\", agent.run(query).content)\n```\n\n```\nQ: Find the capital city of France?\nA: The capital city of France is Paris, which is not only the largest city in the country but also a major global center for art, fashion, and culture. Located in the north-central part of France along the Seine River, Paris is renowned for its iconic landmarks such as the Eiffel Tower, the Louvre Museum, and the Notre-Dame Cathedral. The city has a rich history dating back to its founding in the 3rd century BC as a small fishing village, and over the centuries, it has evolved into a vibrant metropolis known for its stylish boulevards, world-class cuisine, and significant historical events. Paris also serves as the political and administrative hub of France, housing key government institutions, including the \u00c9lys\u00e9e Palace, where the French President resides.\n\nQ: What's the exchange rate of the Brazilian real?\nA: As of January 10, 2025, the exchange rate for the Brazilian Real (BRL) is approximately 6.0604 BRL to 1 USD, with an inverse rate of about 0.1650 USD for 1 BRL. This means that for every Brazilian Real, you can exchange it for about 16.5 cents in US dollars.\n\nQ: What's the exchange rate of the Euro?\nA: As of January 10, 2025, the exchange rate for the Euro (EUR) is approximately 0.9709 against the US Dollar, meaning 1 Euro can be exchanged for about 0.9709 USD; conversely, the inverse rate indicates that 1 USD is equivalent to about 1.0300 Euros.\n\nQ: What's the exchange rate of the Chine Renminbi?\nA: As of January 10, 2025, the exchange rate for the Chinese Renminbi (CNY), also known as the Chinese Yuan, is approximately 7.33 CNY per 1 USD. Additionally, the inverse rate indicates that 1 CNY is equivalent to about 0.1364 USD. This rate is important for various financial transactions, including trade, investments, and tourism related to China, reflecting the currency's strength in the global market as observed at 15:55 GMT on the same date.\n\nQ: What's the exchange rate of the Chinese Yuan?\nA: As of January 10, 2025, the exchange rate for the Chinese Yuan (CNY) is approximately 7.33 CNY to 1 USD, with an inverse rate of about 0.14 USD for each CNY, reflecting its value in the global market. This data indicates the strength of the yuan against the US dollar, and it is essential for understanding its purchasing power and economic interactions, especially for businesses and individuals engaging in international transactions.\n\nQ: What's the exchange rate of the Tonga?\nA: As of January 10, 2025, the current exchange rate for the Tongan pa\u02bbanga (ISO code: TOP) is approximately 2.42 TOP per 1 USD, while the inverse rate is around 0.41 USD per 1 TOP. The Tongan pa\u02bbanga is denoted by the numeric code 776, and the latest exchange data indicates that the rate was last updated at 15:55:14 GMT on the same day.\n```\n\n## Contributing to Gwenflow\n\nWe are very open to the community's contributions - be it a quick fix of a typo, or a completely new feature! You don't\nneed to be a Gwenflow expert to provide meaningful improvements.\n",
"bugtrack_url": null,
"license": null,
"summary": "A framework for orchestrating applications powered by autonomous AI agents and LLMs.",
"version": "0.5.2",
"project_urls": {
"Homepage": "https://gwenlake.com",
"Source": "https://github.com/gwenlake/gwenflow"
},
"split_keywords": [
"gwenflow",
" gwenlake",
" agents",
" llms",
" ai",
" ml",
" nlp",
" framework"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "70c491fe7ef61a76866cd391a7455dca2e2fbee5c997a98dd4622698f7d5beee",
"md5": "f99d79b2c925c11def8b2309b76ed01a",
"sha256": "44a39f612237d55bc2bb01c6d83a1559422c82009ad913e44db879d249073db7"
},
"downloads": -1,
"filename": "gwenflow-0.5.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f99d79b2c925c11def8b2309b76ed01a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 60895,
"upload_time": "2025-01-13T15:11:06",
"upload_time_iso_8601": "2025-01-13T15:11:06.656578Z",
"url": "https://files.pythonhosted.org/packages/70/c4/91fe7ef61a76866cd391a7455dca2e2fbee5c997a98dd4622698f7d5beee/gwenflow-0.5.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "2119aea26bd0b466e407d34597c430885571408caa72cdc535857563cda58039",
"md5": "e41bf40527631b0ad09f30dea3386dca",
"sha256": "efa986d34a450aa7adabcde2b244d6368b5ad0dc14cfcae4848bbcc2f830dab0"
},
"downloads": -1,
"filename": "gwenflow-0.5.2.tar.gz",
"has_sig": false,
"md5_digest": "e41bf40527631b0ad09f30dea3386dca",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 42678,
"upload_time": "2025-01-13T15:11:09",
"upload_time_iso_8601": "2025-01-13T15:11:09.196500Z",
"url": "https://files.pythonhosted.org/packages/21/19/aea26bd0b466e407d34597c430885571408caa72cdc535857563cda58039/gwenflow-0.5.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-13 15:11:09",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "gwenlake",
"github_project": "gwenflow",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "gwenflow"
}
