# just-agents-core
A lightweight, straightforward core library for LLM agents - no over-engineering, just simplicity!
## ðŊ Core Features
- ðŠķ Lightweight base agent implementations
- ð Simple string-based agent interactions
- ð§ YAML-based prompt templating
- ðĪ LLM model integration through litellm
- ð Chain of Thought reasoning capabilities
## ðïļ Core Components
### BaseAgent
A thin wrapper around litellm for basic LLM interactions. Provides:
- Simple prompt management
- Direct LLM communication
- Memory handling
### ChatAgent
The fundamental building block for agent interactions:
```python
from just_agents.simple.chat_agent import ChatAgent
from just_agents.simple.llm_options import LLAMA3_2_VISION
agent = ChatAgent(
llm_options=LLAMA3_2_VISION,
role="assistant",
goal="help the user",
task="answer questions"
)
```
### ChainOfThoughtAgent
Extended agent with reasoning capabilities and function calling:
```python
from just_agents.patterns.chain_of_throught import ChainOfThoughtAgent
agent = ChainOfThoughtAgent(
tools=[your_function],
llm_options=LLAMA3_2_VISION
)
```
## ð Usage
This core package is typically used as a dependency by other just-agents packages. For full usage examples and documentation, please refer to the [main repository](https://github.com/longevity-genie/just-agents).
## ð§ Installation
```bash
pip install just-agents-core
```
Raw data
{
"_id": null,
"home_page": null,
"name": "just-agents-core",
"maintainer": "Anton Kulaga",
"docs_url": null,
"requires_python": "<4.0,>=3.10",
"maintainer_email": "antonkulaga@gmail.com",
"keywords": "python, llm, science, review, agents, AI",
"author": "Alex Karmazin",
"author_email": "karmazinalex@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/1b/5c/01eff11a0f4b88bf869aa04101663855798db362523b59d5ce18949a6905/just_agents_core-0.4.3.tar.gz",
"platform": null,
"description": "# just-agents-core\n\nA lightweight, straightforward core library for LLM agents - no over-engineering, just simplicity!\n\n## \ud83c\udfaf Core Features\n- \ud83e\udeb6 Lightweight base agent implementations\n- \ud83d\udcdd Simple string-based agent interactions\n- \ud83d\udd27 YAML-based prompt templating\n- \ud83e\udd16 LLM model integration through litellm\n- \ud83d\udd04 Chain of Thought reasoning capabilities\n\n## \ud83c\udfd7\ufe0f Core Components\n\n### BaseAgent\nA thin wrapper around litellm for basic LLM interactions. Provides:\n- Simple prompt management\n- Direct LLM communication\n- Memory handling\n\n### ChatAgent\nThe fundamental building block for agent interactions:\n```python\nfrom just_agents.simple.chat_agent import ChatAgent\nfrom just_agents.simple.llm_options import LLAMA3_2_VISION\n\nagent = ChatAgent(\n llm_options=LLAMA3_2_VISION,\n role=\"assistant\",\n goal=\"help the user\",\n task=\"answer questions\"\n)\n```\n\n### ChainOfThoughtAgent\nExtended agent with reasoning capabilities and function calling:\n```python\nfrom just_agents.patterns.chain_of_throught import ChainOfThoughtAgent\n\nagent = ChainOfThoughtAgent(\n tools=[your_function],\n llm_options=LLAMA3_2_VISION\n)\n```\n\n## \ud83d\udcda Usage\nThis core package is typically used as a dependency by other just-agents packages. For full usage examples and documentation, please refer to the [main repository](https://github.com/longevity-genie/just-agents).\n\n## \ud83d\udd27 Installation\n```bash\npip install just-agents-core\n```\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Just Agents - Base Package",
"version": "0.4.3",
"project_urls": {
"Bug Tracker": "https://github.com/longevity-genie/just-agents/issues",
"Documentation": "https://just-agents.readthedocs.io/",
"Homepage": "https://github.com/longevity-genie/just-agents"
},
"split_keywords": [
"python",
" llm",
" science",
" review",
" agents",
" ai"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "ec2bb7d2ea7309683a67caebbc40755a6ddc718217de1d08c16c9e94f70d17b9",
"md5": "05c6a1e04568e6fe3c699ce72531c740",
"sha256": "fcc620960e099f56679d001eb5cebed0682a2c563fcc57d613e6afd418db83b2"
},
"downloads": -1,
"filename": "just_agents_core-0.4.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "05c6a1e04568e6fe3c699ce72531c740",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.10",
"size": 50043,
"upload_time": "2024-12-07T23:38:54",
"upload_time_iso_8601": "2024-12-07T23:38:54.633729Z",
"url": "https://files.pythonhosted.org/packages/ec/2b/b7d2ea7309683a67caebbc40755a6ddc718217de1d08c16c9e94f70d17b9/just_agents_core-0.4.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "1b5c01eff11a0f4b88bf869aa04101663855798db362523b59d5ce18949a6905",
"md5": "40dab240ca5db317f1a0473fd569cdfc",
"sha256": "0013531c55ee1fcbc709d6d8bc65c72348a0f91b2bc93831063c0cde96cb9a33"
},
"downloads": -1,
"filename": "just_agents_core-0.4.3.tar.gz",
"has_sig": false,
"md5_digest": "40dab240ca5db317f1a0473fd569cdfc",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.10",
"size": 35664,
"upload_time": "2024-12-07T23:38:55",
"upload_time_iso_8601": "2024-12-07T23:38:55.884013Z",
"url": "https://files.pythonhosted.org/packages/1b/5c/01eff11a0f4b88bf869aa04101663855798db362523b59d5ce18949a6905/just_agents_core-0.4.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-07 23:38:55",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "longevity-genie",
"github_project": "just-agents",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "just-agents-core"
}