llmfy 0.2.1__tar.gz

llmfy-0.2.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 irufano
+
+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.

llmfy-0.2.1/PKG-INFO

@@ -0,0 +1,158 @@
+Metadata-Version: 2.4
+Name: llmfy
+Version: 0.2.1
+Summary: `LLMfy` is a framework for developing applications with large language models (LLMs).
+Home-page: https://github.com/irufano/llmfy
+Author: irufano
+Author-email: irufano.official@gmail.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires: pydantic
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic
+Provides-Extra: openai
+Requires-Dist: openai; extra == "openai"
+Provides-Extra: boto3
+Requires-Dist: boto3; extra == "boto3"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: provides-extra
+Dynamic: requires
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+
+<div align="center">
+
+  <a href="https://pypi.org/project/aigoofusion/">![llmfy](https://img.shields.io/badge/llmfy-0.2.1-30B445.svg?style=for-the-badge)</a>
+  <a href="">![python](https://img.shields.io/badge/python->=3.12-4392FF.svg?style=for-the-badge&logo=python&logoColor=4392FF)</a>
+
+</div>
+
+# llmfy
+
+![](llmfy-banner.png)
+
+`LLMfy` is a framework for developing applications with large language models (LLMs). 
+- `LLMfy` is llm abstraction to use various llm on one module. 
+- `LLMfyPipe` is llm apps workflow.
+
+## How to install
+
+- Prerequisites:
+  - Install [pydantic](https://pypi.org/project/pydantic) [required], 
+  - Install [openai](https://pypi.org/project/openai) to use OpenAI models [optional].
+  - Install [boto3](https://pypi.org/project/boto3/) to use AWS Bedrock models [optional].
+
+### Using pip
+```sh
+pip install llmfy
+```
+### using requirements.txt
+- Add into requirements.txt
+```txt
+llmfy
+```
+- Then install
+```txt
+pip install -r requirements.txt
+```
+
+## How to use
+### OpenAI models
+To use `OpenAIModel`, add below config to your env:
+- `OPENAI_API_KEY`
+
+### AWS Bedrock models
+To use `BedrockModel`, add below config to your env:
+- `AWS_ACCESS_KEY_ID` 
+- `AWS_SECRET_ACCESS_KEY` 
+- `AWS_BEDROCK_REGION`
+
+## Example
+### LLMfy Example
+```python
+from aigoofusion import (
+    OpenAIModel,
+    OpenAIConfig,
+    LLMfy,
+    Message,
+    Role,
+    openai_usage_tracker,
+    LLMfyException,
+)
+
+def sample_prompt():
+    info = """
+    Irufano adalah seorang software engineer.
+    Dia berasal dari Indonesia.
+    Kamu bisa mengunjungi websitenya di https:://irufano.github.io
+	"""
+
+    # Configuration
+    config = OpenAIConfig(temperature=0.7)
+    llm = OpenAIModel(model="gpt-4o-mini", config=config)
+
+    SYSTEM_PROMPT = """Answer any user questions based solely on the data below:
+    <data>
+    {info}
+    </data>
+    
+    DO NOT response outside context."""
+
+    # Initialize framework
+    framework = LLMfy(llm, system_message=SYSTEM_PROMPT, input_variables=["info"])
+
+    try:
+        messages = [Message(role=Role.USER, content="apa ibukota china")]
+       
+        response = framework.generate(messages, info=info)
+        print(f"\n>> {response.result.content}\n")
+
+    except LLMfyException as e:
+        print(f"{e}")
+
+
+if __name__ == "__main__":
+    sample_prompt()
+```
+
+## Develop as Contributor
+### Build the container
+```sh
+docker-compose build
+```
+
+### Run the container
+```sh
+docker-compose up -d aigoofusion
+```
+
+### Stop the container
+```sh
+docker-compose stop aigoofusion
+```
+
+### Access the container shell
+```sh
+docker exec -it aigoofusion bash
+```
+
+### Build package
+```sh
+python setup.py sdist bdist_wheel
+```
+
+### Upload package
+```sh
+twine upload dist/*
+```

llmfy-0.2.1/README.md

@@ -0,0 +1,126 @@
+
+<div align="center">
+
+  <a href="https://pypi.org/project/aigoofusion/">![llmfy](https://img.shields.io/badge/llmfy-0.2.1-30B445.svg?style=for-the-badge)</a>
+  <a href="">![python](https://img.shields.io/badge/python->=3.12-4392FF.svg?style=for-the-badge&logo=python&logoColor=4392FF)</a>
+
+</div>
+
+# llmfy
+
+![](llmfy-banner.png)
+
+`LLMfy` is a framework for developing applications with large language models (LLMs). 
+- `LLMfy` is llm abstraction to use various llm on one module. 
+- `LLMfyPipe` is llm apps workflow.
+
+## How to install
+
+- Prerequisites:
+  - Install [pydantic](https://pypi.org/project/pydantic) [required], 
+  - Install [openai](https://pypi.org/project/openai) to use OpenAI models [optional].
+  - Install [boto3](https://pypi.org/project/boto3/) to use AWS Bedrock models [optional].
+
+### Using pip
+```sh
+pip install llmfy
+```
+### using requirements.txt
+- Add into requirements.txt
+```txt
+llmfy
+```
+- Then install
+```txt
+pip install -r requirements.txt
+```
+
+## How to use
+### OpenAI models
+To use `OpenAIModel`, add below config to your env:
+- `OPENAI_API_KEY`
+
+### AWS Bedrock models
+To use `BedrockModel`, add below config to your env:
+- `AWS_ACCESS_KEY_ID` 
+- `AWS_SECRET_ACCESS_KEY` 
+- `AWS_BEDROCK_REGION`
+
+## Example
+### LLMfy Example
+```python
+from aigoofusion import (
+    OpenAIModel,
+    OpenAIConfig,
+    LLMfy,
+    Message,
+    Role,
+    openai_usage_tracker,
+    LLMfyException,
+)
+
+def sample_prompt():
+    info = """
+    Irufano adalah seorang software engineer.
+    Dia berasal dari Indonesia.
+    Kamu bisa mengunjungi websitenya di https:://irufano.github.io
+	"""
+
+    # Configuration
+    config = OpenAIConfig(temperature=0.7)
+    llm = OpenAIModel(model="gpt-4o-mini", config=config)
+
+    SYSTEM_PROMPT = """Answer any user questions based solely on the data below:
+    <data>
+    {info}
+    </data>
+    
+    DO NOT response outside context."""
+
+    # Initialize framework
+    framework = LLMfy(llm, system_message=SYSTEM_PROMPT, input_variables=["info"])
+
+    try:
+        messages = [Message(role=Role.USER, content="apa ibukota china")]
+       
+        response = framework.generate(messages, info=info)
+        print(f"\n>> {response.result.content}\n")
+
+    except LLMfyException as e:
+        print(f"{e}")
+
+
+if __name__ == "__main__":
+    sample_prompt()
+```
+
+## Develop as Contributor
+### Build the container
+```sh
+docker-compose build
+```
+
+### Run the container
+```sh
+docker-compose up -d aigoofusion
+```
+
+### Stop the container
+```sh
+docker-compose stop aigoofusion
+```
+
+### Access the container shell
+```sh
+docker exec -it aigoofusion bash
+```
+
+### Build package
+```sh
+python setup.py sdist bdist_wheel
+```
+
+### Upload package
+```sh
+twine upload dist/*
+```

llmfy-0.2.1/app/__init__.py

@@ -0,0 +1,64 @@
+from .llmfy import (
+    LLMfy,
+    AIResponse,
+    ChatResponse,
+    Message,
+    Role,
+    Tool,
+    ToolRegistry,
+    OpenAIConfig,
+    OpenAIModel,
+    openai_usage_tracker,
+    track_openai_usage,
+    openai_stream_usage_tracker,
+    BedrockConfig,
+    BedrockModel,
+    bedrock_usage_tracker,
+    track_bedrock_usage,
+    bedrock_stream_usage_tracker,
+    llmfy_usage_tracker,
+)
+
+from .exception import LLMfyException
+
+from .llmfypipe import (
+    LLMfyPipe,
+    Edge,
+    tools_node,
+    Node,
+    WorkflowState,
+    MemoryManager,
+    START,
+    END,
+)
+
+__all__ = [
+    "LLMfy",
+    "Message",
+    "Role",
+    "Tool",
+    "ToolRegistry",
+    "AIResponse",
+    "ChatResponse",
+    "OpenAIConfig",
+    "OpenAIModel",
+    "track_openai_usage",
+    "openai_usage_tracker",
+    "openai_stream_usage_tracker",
+    "LLMfyException",
+    "LLMfyPipe",
+    "Edge",
+    "tools_node",
+    "Node",
+    "START",
+    "END",
+    "WorkflowState",
+    "MemoryManager",
+    "BedrockConfig",
+    "BedrockModel",
+    "bedrock_usage_tracker",
+    "track_bedrock_usage",
+    "bedrock_stream_usage_tracker",
+    "LLMfyUsage",
+    "llmfy_usage_tracker",
+]

llmfy-0.2.1/app/exception/__init__.py

@@ -0,0 +1,3 @@
+from .llmfy_exception import LLMfyException
+
+__all__ = ["LLMfyException"]

llmfy-0.2.1/app/exception/llmfy_exception.py

@@ -0,0 +1,4 @@
+class LLMfyException(Exception):
+    """LLMfyException Class"""
+
+    pass

llmfy-0.2.1/app/llmfy/__init__.py

@@ -0,0 +1,60 @@
+from .llmfy import LLMfy
+from .messages import Message, MessageTemp, Role, ToolCall, Content, ContentType
+from .tools import ToolRegistry, Tool
+from .responses import AIResponse, ChatResponse
+from .models import (
+    BaseAIModel,
+    ModelPricing,
+    OpenAIConfig,
+    OpenAIModel,
+    OPENAI_PRICING,
+    track_openai_usage,
+    openai_usage_tracker,
+    track_openai_stream_usage,
+    openai_stream_usage_tracker,
+    OpenAIUsage,
+    BedrockFormatter,
+    BedrockConfig,
+    BedrockModel,
+    BEDROCK_PRICING,
+    bedrock_usage_tracker,
+    track_bedrock_usage,
+    BedrockUsage,
+    bedrock_stream_usage_tracker,
+    track_bedrock_stream_usage,
+)
+from .usage import llmfy_usage_tracker
+
+__all__ = [
+    "LLMfy",
+    "MessageTemp",
+    "Message",
+    "Role",
+    "ToolCall",
+    "ToolRegistry",
+    "Tool",
+    "AIResponse",
+    "ChatResponse",
+    "BaseAIModel",
+    "ModelPricing",
+    "OpenAIConfig",
+    "OpenAIModel",
+    "OPENAI_PRICING",
+    "track_openai_usage",
+    "openai_usage_tracker",
+    "track_openai_stream_usage",
+    "openai_stream_usage_tracker",
+    "OpenAIUsage",
+    "BedrockConfig",
+    "BedrockFormatter",
+    "BedrockModel",
+    "BEDROCK_PRICING",
+    "bedrock_usage_tracker",
+    "track_bedrock_usage",
+    "BedrockUsage",
+    "bedrock_stream_usage_tracker",
+    "track_bedrock_stream_usage",
+    "Content",
+    "ContentType",
+    "llmfy_usage_tracker",
+]