Add project structure files (#3)

- chore: Add repository structure files (3ea4ef03ff1d1cba8bfa04637618f0a28a659371)
- feat: Add langgraph chat with bedrock (4a76b1f710e84b6b7cfc6a05e946df474b4d1b91)

.gitignore

@@ -0,0 +1,130 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+env/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# dotenv
+.env
+
+# virtualenv
+.venv
+venv/
+ENV/
+
+# Sphinx documentation
+docs/_build/
+
+# mkdocs documentation
+/site
+docs/*.png
+
+# mypy
+.mypy_cache/
+
+# vscode cache
+.vscode
+
+# Pycharm files
+.idea
+
+### macOS template
+*.DS_Store
+.AppleDouble
+.LSOverride
+
+# serverless
+**/.serverless
+**/node_modules
+
+# terraform
+**/.terraform
+*.tfstate*
+
+# exclude temp files from source control
+temp/
+tmp/
+
+# exclude data from source control by default
+/data/*
+
+!/data/sat2023-sample/
+!/data/cnf-sample/
+
+!/data/sat2023-cos-similarity-dataset/
+/data/sat2023-cos-similarity-dataset/*
+!/data/sat2023-cos-similarity-dataset/results_main_detailed.csv
+
+# Configurations
+/config/
+
+# Logs
+lightning_logs/
+
+# Models
+/models/
+
+
+# Poetry code artifact settings
+.poetry/
+poetry.toml
+
+# Mise
+.mise.toml
+mise.toml

.pre-commit-config.yaml

@@ -0,0 +1,118 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v2.4.0
+    hooks:
+      - id: requirements-txt-fixer
+        files: requirements.txt|requirements-dev.txt|requirements-test.txt
+      - id: trailing-whitespace
+        exclude: |
+          (?x)^(
+            notebooks/
+          )
+        args: [--markdown-linebreak-ext=md]
+      - id: end-of-file-fixer
+        exclude: |
+          (?x)^(
+            notebooks/
+          )
+      - id: check-yaml
+      - id: check-symlinks
+      - id: check-toml
+      - id: check-added-large-files
+        args: ["--maxkb=1000"]
+  - repo: https://github.com/asottile/add-trailing-comma
+    rev: v3.1.0
+    hooks:
+      - id: add-trailing-comma
+  - repo: https://github.com/psf/black
+    rev: 23.1.0
+    hooks:
+      - id: black
+        exclude: |
+          (?x)^(
+            notebooks/
+          )
+  - repo: https://github.com/pycqa/isort
+    rev: "5.12.0"
+    hooks:
+      - id: isort
+        exclude: |
+          (?x)^(
+            notebooks/
+          )
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.9.7
+    hooks:
+      - id: ruff # linter
+        exclude: |
+          (?x)^(
+            scripts/|
+            notebooks/
+          )
+      # - id: ruff-format
+  - repo: local
+    hooks:
+      - id: update-req
+        name: Update requirements.txt
+        stages: [pre-commit]
+        language: system
+        entry: uv
+        files: uv.lock|requirements.txt
+        pass_filenames: false
+        args:
+          [
+            "export",
+            "--format",
+            "requirements-txt",
+            "--no-hashes",
+            "--no-dev",
+            "-o",
+            "requirements.txt",
+          ]
+      - id: update-dev-req
+        name: Update requirements-dev.txt
+        stages: [pre-commit]
+        language: system
+        entry: uv
+        files: uv.lock|requirements-dev.txt
+        pass_filenames: false
+        args:
+          [
+            "export",
+            "--format",
+            "requirements-txt",
+            "--no-hashes",
+            "--group",
+            "dev",
+            "--group",
+            "test",
+            "-o",
+            "requirements-dev.txt",
+          ]
+      - id: mypy
+        name: Running mypy
+        stages: [commit]
+        language: system
+        entry: uv run mypy
+        args: [--install-types, --non-interactive]
+        types: [python]
+        exclude: |
+          (?x)^(
+            scripts/|
+            notebooks/
+          )
+
+      # - id: pytest
+      #   name: pytest
+      #   stages: [commit]
+      #   language: system
+      #   entry: poetry run pytest
+      #   types: [python]
+
+      # - id: pytest-cov
+      #   name: pytest
+      #   stages: [push]
+      #   language: system
+      #   entry: poetry run pytest --cov --cov-fail-under=100
+      #   types: [python]
+      #   pass_filenames: false

README.md

@@ -11,4 +11,20 @@ license: apache-2.0
 short_description: tdb
 ---
 
-An example chatbot using [Gradio](https://gradio.app), [`huggingface_hub`](https://huggingface.co/docs/huggingface_hub/v0.22.2/en/index), and the [Hugging Face Inference API](https://huggingface.co/docs/api-inference/index).
+# TDA Agent
+
+# Development setup
+
+To start developing you need the following tools:
+
+ * [uv](https://docs.astral.sh/uv/)
+
+To start, sync all the dependencies with `uv sync --all-groups`.
+Then, install the pre-commit hooks (`uv run pre-commit install`) to
+ensure that future commits comply with the bare minimum to keep
+code _readable_.
+
+
+## Old content
+
+An example chatbot using [Gradio](https://gradio.app), [`huggingface_hub`](https://huggingface.co/docs/huggingface_hub/v0.22.2/en/index), and the [Hugging Face Inference API](https://huggingface.co/docs/api-inference/index).

app.py

@@ -1,64 +1,4 @@
-import gradio as gr
-from huggingface_hub import InferenceClient
-
-"""
-For more information on `huggingface_hub` Inference API support, please check the docs: https://huggingface.co/docs/huggingface_hub/v0.22.2/en/guides/inference
-"""
-client = InferenceClient("HuggingFaceH4/zephyr-7b-beta")
-
-
-def respond(
-    message,
-    history: list[tuple[str, str]],
-    system_message,
-    max_tokens,
-    temperature,
-    top_p,
-):
-    messages = [{"role": "system", "content": system_message}]
-
-    for val in history:
-        if val[0]:
-            messages.append({"role": "user", "content": val[0]})
-        if val[1]:
-            messages.append({"role": "assistant", "content": val[1]})
-
-    messages.append({"role": "user", "content": message})
-
-    response = ""
-
-    for message in client.chat_completion(
-        messages,
-        max_tokens=max_tokens,
-        stream=True,
-        temperature=temperature,
-        top_p=top_p,
-    ):
-        token = message.choices[0].delta.content
-
-        response += token
-        yield response
-
-
-"""
-For information on how to customize the ChatInterface, peruse the gradio docs: https://www.gradio.app/docs/chatinterface
-"""
-demo = gr.ChatInterface(
-    respond,
-    additional_inputs=[
-        gr.Textbox(value="You are a friendly Chatbot.", label="System message"),
-        gr.Slider(minimum=1, maximum=2048, value=512, step=1, label="Max new tokens"),
-        gr.Slider(minimum=0.1, maximum=4.0, value=0.7, step=0.1, label="Temperature"),
-        gr.Slider(
-            minimum=0.1,
-            maximum=1.0,
-            value=0.95,
-            step=0.05,
-            label="Top-p (nucleus sampling)",
-        ),
-    ],
-)
-
+from tdagent.grchat import gr_app
 
 if __name__ == "__main__":
-    demo.launch()
+    gr_app.launch()

pyproject.toml

@@ -0,0 +1,130 @@
+[project]
+name = "tdagent"
+version = "0.1.0"
+description = "TDA Agent implemented for huggingface hackathon."
+authors = [
+    { name = "Pedro Completo Bento", email = "[email protected]" },
+    { name = "Josep Pon Farreny", email = "[email protected]" },
+    { name = "Miguel Rodin Rodriguez", email = "[email protected]" },
+    { name = "Sofia Jeronimo dos Santos", email = "[email protected]" },
+    { name = "Rodrigo Dominguez Sanz", email = "[email protected]" },
+]
+requires-python = ">=3.10,<4"
+readme = "README.md"
+license = ""
+dependencies = [
+    "gradio[mcp]>=5.32.1",
+    "huggingface-hub>=0.32.3",
+    "langchain-aws>=0.2.24",
+    "langgraph>=0.4.7",
+]
+
+[project.scripts]
+
+
+[dependency-groups]
+dev = ["mypy~=1.14", "ruff>=0.9,<1", "pre-commit~=3.4", "pip-audit>=2.9.0"]
+test = [
+    "pytest>=7.4.4,<8",
+    "pytest-cov>=4.1.0,<5",
+    "pytest-randomly>=3.15.0,<4",
+    "xdoctest>=1.1.2,<2",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.uv]
+package = false
+default-groups = ["dev", "test"]
+
+[tool.uv.workspace]
+members = ["test"]
+
+[tool.black]
+target-version = ["py39", "py310", "py311"]
+line-length = 88
+
+[tool.isort]
+profile = "black"
+lines_after_imports = 2
+
+[tool.mypy]
+cache_dir = ".cache/mypy/"
+ignore_missing_imports = true
+no_implicit_optional = true
+check_untyped_defs = true
+strict_equality = true
+disallow_any_generics = true
+disallow_subclassing_any = true
+disallow_untyped_calls = true
+disallow_untyped_defs = true
+disallow_incomplete_defs = true
+disallow_untyped_decorators = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+exclude = "docs/"
+plugins = ["pydantic.mypy"]        # ["numpy.typing.mypy_plugin"]
+
+[[tool.mypy.overrides]]
+module = "tests.*"
+disallow_untyped_defs = false
+disallow_incomplete_defs = false
+
+[tool.pytest.ini_options]
+cache_dir = ".cache"
+testpaths = ["tests", "tda_agent"]
+addopts = [
+    "--strict",
+    "-r sxX",
+    "--cov-report=html",
+    "--cov-report=term-missing:skip-covered",
+    "--no-cov-on-fail",
+    "--xdoc",
+]
+console_output_style = "count"
+markers = ""
+filterwarnings = ["ignore::DeprecationWarning"]
+
+[tool.ruff]
+cache-dir = ".cache/ruff"
+exclude = [
+    ".git",
+    "__pycache__",
+    "docs/source/conf.py",
+    "old",
+    "build",
+    "dist",
+    ".venv",
+    "scripts",
+]
+line-length = 88
+
+[tool.ruff.lint]
+select = ["ALL"]
+ignore = ["D100", "D104", "D107", "D401", "EM102", "ERA001", "TRY003"]
+
+[tool.ruff.lint.flake8-quotes]
+inline-quotes = "double"
+
+[tool.ruff.lint.flake8-bugbear]
+# Allow default arguments like, e.g., `data: List[str] = fastapi.Query(None)`.
+extend-immutable-calls = ["typer.Argument", "typer.Option"]
+
+[tool.ruff.lint.pep8-naming]
+ignore-names = ["F", "L"]
+
+[tool.ruff.lint.isort]
+lines-after-imports = 2
+
+[tool.ruff.lint.mccabe]
+max-complexity = 18
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.ruff.lint.per-file-ignores]
+"*/__init__.py" = ["F401"]
+"tdagent/cli/**/*.py" = ["D103", "T201"]
+"tests/*.py" = ["D103", "PLR2004", "S101"]

requirements-dev.txt

@@ -0,0 +1,55 @@
+# This file was autogenerated by uv via the following command:
+#    uv export --format requirements-txt --no-hashes --group dev --group test -o requirements-dev.txt
+boolean-py==5.0
+cachecontrol==0.14.3
+certifi==2025.4.26
+cfgv==3.4.0
+charset-normalizer==3.4.2
+colorama==0.4.6 ; sys_platform == 'win32'
+coverage==7.8.2
+cyclonedx-python-lib==9.1.0
+defusedxml==0.7.1
+distlib==0.3.9
+exceptiongroup==1.3.0 ; python_full_version < '3.11'
+filelock==3.18.0
+fsspec==2025.5.1
+hf-xet==1.1.2 ; platform_machine == 'aarch64' or platform_machine == 'amd64' or platform_machine == 'arm64' or platform_machine == 'x86_64'
+huggingface-hub==0.32.3
+identify==2.6.12
+idna==3.10
+iniconfig==2.1.0
+license-expression==30.4.1
+markdown-it-py==3.0.0
+mdurl==0.1.2
+msgpack==1.1.0
+mypy==1.16.0
+mypy-extensions==1.1.0
+nodeenv==1.9.1
+packageurl-python==0.16.0
+packaging==25.0
+pathspec==0.12.1
+pip==25.1.1
+pip-api==0.0.34
+pip-audit==2.9.0
+pip-requirements-parser==32.0.1
+platformdirs==4.3.8
+pluggy==1.6.0
+pre-commit==3.8.0
+py-serializable==2.0.0
+pygments==2.19.1
+pyparsing==3.2.3
+pytest==7.4.4
+pytest-cov==4.1.0
+pytest-randomly==3.16.0
+pyyaml==6.0.2
+requests==2.32.3
+rich==14.0.0
+ruff==0.11.12
+sortedcontainers==2.4.0
+toml==0.10.2
+tomli==2.2.1 ; python_full_version <= '3.11'
+tqdm==4.67.1
+typing-extensions==4.13.2
+urllib3==2.4.0
+virtualenv==20.31.2
+xdoctest==1.2.0

requirements.txt

@@ -1 +1,25 @@
-huggingface_hub==0.25.2
+# This file was autogenerated by uv via the following command:
+#    uv export --format requirements-txt --no-hashes --no-dev -o requirements.txt
+certifi==2025.4.26
+charset-normalizer==3.4.2
+colorama==0.4.6 ; sys_platform == 'win32'
+coverage==7.8.2
+exceptiongroup==1.3.0 ; python_full_version < '3.11'
+filelock==3.18.0
+fsspec==2025.5.1
+hf-xet==1.1.2 ; platform_machine == 'aarch64' or platform_machine == 'amd64' or platform_machine == 'arm64' or platform_machine == 'x86_64'
+huggingface-hub==0.32.3
+idna==3.10
+iniconfig==2.1.0
+packaging==25.0
+pluggy==1.6.0
+pytest==7.4.4
+pytest-cov==4.1.0
+pytest-randomly==3.16.0
+pyyaml==6.0.2
+requests==2.32.3
+tomli==2.2.1 ; python_full_version <= '3.11'
+tqdm==4.67.1
+typing-extensions==4.13.2
+urllib3==2.4.0
+xdoctest==1.2.0

tdagent/grchat.py

@@ -0,0 +1,202 @@
+from __future__ import annotations
+
+from collections.abc import Mapping
+from types import MappingProxyType
+
+import boto3
+import botocore
+import botocore.exceptions
+import gradio as gr
+from langchain_aws import ChatBedrock
+from langchain_core.messages import AIMessage, HumanMessage, SystemMessage
+from langgraph.graph.graph import CompiledGraph
+from langgraph.prebuilt import create_react_agent
+
+
+#### Constants ####
+
+SYSTEM_MESSAGE = SystemMessage(
+    "You are a helpful assistant.",
+)
+
+GRADIO_ROLE_TO_LG_MESSAGE_TYPE = MappingProxyType(
+    {
+        "user": HumanMessage,
+        "assistant": AIMessage,
+    },
+)
+
+
+#### Shared variables ####
+
+llm_agent: CompiledGraph | None = None
+
+#### Utility functions ####
+
+
+def create_bedrock_llm(
+    bedrock_model_id: str,
+    aws_access_key: str,
+    aws_secret_key: str,
+    aws_session_token: str,
+    aws_region: str,
+) -> tuple[ChatBedrock | None, str]:
+    """Create a LangGraph Bedrock agent."""
+    boto3_config = {
+        "aws_access_key_id": aws_access_key,
+        "aws_secret_access_key": aws_secret_key,
+        "aws_session_token": aws_session_token if aws_session_token else None,
+        "region_name": aws_region,
+    }
+
+    # Verify credentials
+    try:
+        sts = boto3.client("sts", **boto3_config)
+        sts.get_caller_identity()
+    except botocore.exceptions.ClientError as err:
+        return None, str(err)
+
+    try:
+        bedrock_client = boto3.client("bedrock-runtime", **boto3_config)
+        llm = ChatBedrock(
+            model=bedrock_model_id,
+            client=bedrock_client,
+            model_kwargs={"temperature": 0.7},
+        )
+    except Exception as e:  # noqa: BLE001
+        return None, str(e)
+
+    return llm, ""
+
+
+#### UI functionality ####
+
+
+async def gr_connect_to_bedrock(
+    model_id: str,
+    access_key: str,
+    secret_key: str,
+    session_token: str,
+    region: str,
+) -> str:
+    """Initialize Bedrock agent."""
+    global llm_agent  # noqa: PLW0603
+
+    if not access_key or not secret_key:
+        return "❌ Please provide both Access Key ID and Secret Access Key"
+
+    llm, error = create_bedrock_llm(
+        model_id,
+        access_key.strip(),
+        secret_key.strip(),
+        session_token.strip(),
+        region,
+    )
+
+    if llm is None:
+        return f"❌ Connection failed: {error}"
+
+    llm_agent = create_react_agent(
+        model=llm,
+        tools=[],
+        prompt=SYSTEM_MESSAGE,
+    )
+
+    return "✅ Successfully connected to AWS Bedrock!"
+
+
+async def gr_chat_function(  # noqa: D103
+    message: str,
+    history: list[Mapping[str, str]],
+) -> str:
+    if llm_agent is None:
+        return "Please configure your credentials first."
+
+    messages = []
+    for hist_msg in history:
+        role = hist_msg["role"]
+        message_type = GRADIO_ROLE_TO_LG_MESSAGE_TYPE[role]
+        messages.append(message_type(content=hist_msg["content"]))
+
+    messages.append(HumanMessage(content=message))
+
+    llm_response = await llm_agent.ainvoke(
+        {
+            "messages": messages,
+        },
+    )
+
+    return llm_response["messages"][-1].content
+
+
+## UI components ##
+
+with gr.Blocks() as gr_app:
+    gr.Markdown("# 🔐 Secure Bedrock Chatbot")
+
+    # Credentials section (collapsible)
+    with gr.Accordion("🔑 Bedrock Configuration", open=True):
+        gr.Markdown(
+            "**Note**: Credentials are only stored in memory during your session.",
+        )
+        with gr.Row():
+            bedrock_model_id_textbox = gr.Textbox(
+                label="Bedrock Model Id",
+                value="eu.anthropic.claude-3-5-sonnet-20240620-v1:0",
+            )
+        with gr.Row():
+            aws_access_key_textbox = gr.Textbox(
+                label="AWS Access Key ID",
+                type="password",
+                placeholder="Enter your AWS Access Key ID",
+            )
+            aws_secret_key_textbox = gr.Textbox(
+                label="AWS Secret Access Key",
+                type="password",
+                placeholder="Enter your AWS Secret Access Key",
+            )
+        with gr.Row():
+            aws_session_token_textbox = gr.Textbox(
+                label="AWS Session Token",
+                type="password",
+                placeholder="Enter your AWS session token",
+            )
+        with gr.Row():
+            aws_region_dropdown = gr.Dropdown(
+                label="AWS Region",
+                choices=[
+                    "us-east-1",
+                    "us-west-2",
+                    "eu-west-1",
+                    "eu-central-1",
+                    "ap-southeast-1",
+                ],
+                value="eu-west-1",
+            )
+            connect_btn = gr.Button("🔌 Connect to Bedrock", variant="primary")
+
+        status_textbox = gr.Textbox(label="Connection Status", interactive=False)
+
+        connect_btn.click(
+            gr_connect_to_bedrock,
+            inputs=[
+                bedrock_model_id_textbox,
+                aws_access_key_textbox,
+                aws_secret_key_textbox,
+                aws_session_token_textbox,
+                aws_region_dropdown,
+            ],
+            outputs=[status_textbox],
+        )
+
+    chat_interface = gr.ChatInterface(
+        fn=gr_chat_function,
+        type="messages",
+        examples=[],
+        title="Agent with MCP Tools",
+        description="This is a simple agent that uses MCP tools.",
+    )
+
+
+if __name__ == "__main__":
+    gr_app.launch()