# Discussion Agents
## Features
Our primary goal is to provide easy-to-use and clean functions for natural language processing tasks, enabling developers to build robust and efficient applications with ease.
- Easy-to-Use Interface: Provides intuitive and user-friendly functions for rapid prototyping and development.
- Clean Functions: Offers clean and well-structured functions, promoting readability and maintainability of code.
- Modularized Implementations: Includes modularized implementations of popular LLM-based agents and agent-related methods, allowing users to leverage cutting-edge innovations from the literature.
## Getting Started
```python
question = 'Who was once considered the best kick boxer in the world, however he has been involved in a number of controversies relating to his "unsportsmanlike conducts" in the sport and crimes of violence outside of the ring?'
llm = ChatOpenAI(openai_api_key="YOUR_API_KEY")
agent = ReActAgent(llm=llm)
out = agent.generate(question=question)
```
Here's what the output would look like!
```
Thought : I need to search for the best kick boxer in the world, and then find any controversies or crimes they have been involved in.
Action : Search[best kick boxer in the world]
Observation : (Result 1/1) Ramon Dekkers is considered by many to be the best kickboxer in the world.
Thought : It mentions "unsportsmanlike conducts" and crimes of violence. I need to find more information about Ramon Dekkers.
Action : Lookup[crimes]
Observation: (Result 1/1) Dekkers was involved in a number of controversies relating to his "unsportsmanlike conducts" in the sport and crimes of violence outside of the ring.
Thought: Ramon Dekkers has been involved in controversies and crimes. I need to find more information about them.
...
```
## Project Organization
------------
├── data
│ ├── external <- Data from third party sources.
│ ├── interim <- Intermediate data that has been transformed.
│ ├── processed <- The final, canonical data sets for modeling.
│ └── raw <- The original, immutable data dump.
│
├── discussion_agents <- Source code for this project.
│ ├── cog
│ │ ├── agent <- Model/agent-related modules.
│ │ │
│ │ ├── eval <- Agent core modules.
│ │ │
│ │ ├── functional
│ │ │
│ │ ├── modules
│ │ │ ├── memory <- Memory-related modules.
│ │ │ ├── plan <- Planning-related modules.
│ │ │ ├── reflect <- Reflecting-related modules.
│ │ │ └── score <- Scoring-related modules.
│ │ │
│ │ ├── persona
│ │ │
│ │ └── prompts
│ │
│ └── utils <- Utility methods.
│
├── docs <- A default Sphinx project; see sphinx-doc.org for details.
│
├── models <- Trained and serialized models, model predictions,
│ or model summaries.
│
├── notebooks <- Jupyter notebooks. Naming convention is a number
│ (for ordering), the creator's initials, and a short `-` delimited │ description, e.g. `1.0-jqp-initial-data-exploration`.
│
│
├── references <- Data dictionaries, manuals, and all other explanatory materials.
│
├── reports <- Generated analysis as HTML, PDF, LaTeX, etc.
│ └── figures <- Generated graphics and figures to be used in reporting.
│
└── tests <- Tests.
---------
## Contributing
If you want to contribute, please check the [contributing.md](https://github.com/alckasoc/discussion-agents/blob/main/CONTRIBUTING.md) for guidelines!
Raw data
{
"_id": null,
"home_page": "https://github.com/alckasoc/discussion-agents",
"name": "discussion_agents",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.9",
"maintainer_email": null,
"keywords": "packaging, poetry, agent, LLM",
"author": "Vincent Tu",
"author_email": "tuvincent0106@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/7b/a9/3e453130fc7aaa07847615e13f2470085705499de06e587b01a66f83b9c6/discussion_agents-0.0.1.tar.gz",
"platform": null,
"description": "\n# Discussion Agents\n\n\n## Features\n\n\n Our primary goal is to provide easy-to-use and clean functions for natural language processing tasks, enabling developers to build robust and efficient applications with ease.\n\n- Easy-to-Use Interface: Provides intuitive and user-friendly functions for rapid prototyping and development.\n\n- Clean Functions: Offers clean and well-structured functions, promoting readability and maintainability of code.\n\n- Modularized Implementations: Includes modularized implementations of popular LLM-based agents and agent-related methods, allowing users to leverage cutting-edge innovations from the literature.\n\n\n## Getting Started \n\n```python\nquestion = 'Who was once considered the best kick boxer in the world, however he has been involved in a number of controversies relating to his \"unsportsmanlike conducts\" in the sport and crimes of violence outside of the ring?'\n\nllm = ChatOpenAI(openai_api_key=\"YOUR_API_KEY\")\nagent = ReActAgent(llm=llm)\nout = agent.generate(question=question)\n```\n\n\nHere's what the output would look like!\n```\nThought : I need to search for the best kick boxer in the world, and then find any controversies or crimes they have been involved in.\nAction : Search[best kick boxer in the world]\nObservation : (Result 1/1) Ramon Dekkers is considered by many to be the best kickboxer in the world.\nThought : It mentions \"unsportsmanlike conducts\" and crimes of violence. I need to find more information about Ramon Dekkers.\nAction : Lookup[crimes]\nObservation: (Result 1/1) Dekkers was involved in a number of controversies relating to his \"unsportsmanlike conducts\" in the sport and crimes of violence outside of the ring.\nThought: Ramon Dekkers has been involved in controversies and crimes. I need to find more information about them.\n...\n```\n\n\n## Project Organization\n\n------------\n\n \n\n \u251c\u2500\u2500 data\n \u2502\u00a0\u00a0 \u251c\u2500\u2500 external <- Data from third party sources.\n \u2502\u00a0\u00a0 \u251c\u2500\u2500 interim <- Intermediate data that has been transformed.\n \u2502\u00a0\u00a0 \u251c\u2500\u2500 processed <- The final, canonical data sets for modeling.\n \u2502\u00a0\u00a0 \u2514\u2500\u2500 raw <- The original, immutable data dump.\n \u2502\n \u251c\u2500\u2500 discussion_agents <- Source code for this project.\n \u2502\u00a0\u00a0 \u251c\u2500\u2500 cog \n \u2502 \u2502 \u251c\u2500\u2500 agent <- Model/agent-related modules.\n \u2502 \u2502 \u2502 \n \u2502 \u2502 \u251c\u2500\u2500 eval <- Agent core modules.\n \u2502 \u2502 \u2502 \n \u2502 \u2502 \u251c\u2500\u2500 functional \n \u2502 \u2502 \u2502\n \u2502 \u2502 \u251c\u2500\u2500 modules \n \u2502 \u2502 \u2502 \u251c\u2500\u2500 memory <- Memory-related modules.\n \u2502 \u2502 \u2502 \u251c\u2500\u2500 plan <- Planning-related modules.\n \u2502 \u2502 \u2502 \u251c\u2500\u2500 reflect <- Reflecting-related modules.\n \u2502 \u2502 \u2502 \u2514\u2500\u2500 score <- Scoring-related modules.\n \u2502 \u2502 \u2502\n \u2502 \u2502 \u251c\u2500\u2500 persona \n \u2502 \u2502 \u2502\n \u2502 \u2502 \u2514\u2500\u2500 prompts \n \u2502 \u2502\n \u2502 \u2514\u2500\u2500 utils <- Utility methods.\n \u2502 \n \u251c\u2500\u2500 docs <- A default Sphinx project; see sphinx-doc.org for details.\n \u2502\n \u251c\u2500\u2500 models <- Trained and serialized models, model predictions,\n \u2502 or model summaries.\n \u2502 \n \u251c\u2500\u2500 notebooks <- Jupyter notebooks. Naming convention is a number \n \u2502 (for ordering), the creator's initials, and a short `-` delimited \u2502 description, e.g. `1.0-jqp-initial-data-exploration`.\n \u2502 \n \u2502\n \u251c\u2500\u2500 references <- Data dictionaries, manuals, and all other explanatory materials.\n \u2502\n \u251c\u2500\u2500 reports <- Generated analysis as HTML, PDF, LaTeX, etc.\n \u2502\u00a0\u00a0 \u2514\u2500\u2500 figures <- Generated graphics and figures to be used in reporting.\n \u2502\n \u2514\u2500\u2500 tests <- Tests.\n\n---------\n\n\n## Contributing\n\nIf you want to contribute, please check the [contributing.md](https://github.com/alckasoc/discussion-agents/blob/main/CONTRIBUTING.md) for guidelines!\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A flexible agent library.",
"version": "0.0.1",
"project_urls": {
"Homepage": "https://github.com/alckasoc/discussion-agents",
"Repository": "https://github.com/alckasoc/discussion-agents"
},
"split_keywords": [
"packaging",
" poetry",
" agent",
" llm"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "9349671e601c5aae0a22fa51a9cb3dbb95f447f306a4a2770f7ab37b12e48478",
"md5": "215cf11dba4bcce79c4f09971f675ea1",
"sha256": "5b265b3cd089fa78d141dc73c7e589bdbd211f6b1582a170b0b85e1023d2b125"
},
"downloads": -1,
"filename": "discussion_agents-0.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "215cf11dba4bcce79c4f09971f675ea1",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.9",
"size": 90501,
"upload_time": "2024-04-10T05:04:21",
"upload_time_iso_8601": "2024-04-10T05:04:21.845863Z",
"url": "https://files.pythonhosted.org/packages/93/49/671e601c5aae0a22fa51a9cb3dbb95f447f306a4a2770f7ab37b12e48478/discussion_agents-0.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "7ba93e453130fc7aaa07847615e13f2470085705499de06e587b01a66f83b9c6",
"md5": "344c61842d4b00c0e6b734520dc1bccd",
"sha256": "038a43f505f8576234390d06e507960df74d53791b9775bbb558084761df078f"
},
"downloads": -1,
"filename": "discussion_agents-0.0.1.tar.gz",
"has_sig": false,
"md5_digest": "344c61842d4b00c0e6b734520dc1bccd",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.9",
"size": 68765,
"upload_time": "2024-04-10T05:04:23",
"upload_time_iso_8601": "2024-04-10T05:04:23.761419Z",
"url": "https://files.pythonhosted.org/packages/7b/a9/3e453130fc7aaa07847615e13f2470085705499de06e587b01a66f83b9c6/discussion_agents-0.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-10 05:04:23",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "alckasoc",
"github_project": "discussion-agents",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "discussion_agents"
}
JSON
