claudia-agent 1.4.0__tar.gz

claudia_agent-1.4.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Irae Hueck Costa
+
+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.

claudia_agent-1.4.0/PKG-INFO

@@ -0,0 +1,38 @@
+Metadata-Version: 2.4
+Name: claudia-agent
+Version: 1.4.0
+Summary: Add your description here
+Author-email: Irae Hueck Costa <mail@irae.me>
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: llm>=0.31
+Requires-Dist: prompt-toolkit>=3.0.52
+Requires-Dist: tqdm>=4.67.3
+Dynamic: license-file
+
+# Claudia
+
+Claudia is a command-line tool that uses DeepSeek's language models to implement code changes in your git repository based on natural language task descriptions.
+
+## Usage
+
+```bash
+export DEEPSEEK_API_KEY=your_key_here
+
+uvx claudia "Add email verification to the login form"
+
+# Interactive mode
+uvx claudia
+```
+
+## Why?
+Speed and cost. About two orders of magnitude cheaper than claude.
+
+
+## Requirements
+
+- Python 3.10+
+- A DeepSeek API key (`DEEPSEEK_API_KEY` environment variable)
+- Git
+- Universal Ctags (for project analysis)

claudia_agent-1.4.0/README.md

@@ -0,0 +1,25 @@
+# Claudia
+
+Claudia is a command-line tool that uses DeepSeek's language models to implement code changes in your git repository based on natural language task descriptions.
+
+## Usage
+
+```bash
+export DEEPSEEK_API_KEY=your_key_here
+
+uvx claudia "Add email verification to the login form"
+
+# Interactive mode
+uvx claudia
+```
+
+## Why?
+Speed and cost. About two orders of magnitude cheaper than claude.
+
+
+## Requirements
+
+- Python 3.10+
+- A DeepSeek API key (`DEEPSEEK_API_KEY` environment variable)
+- Git
+- Universal Ctags (for project analysis)

claudia_agent-1.4.0/pyproject.toml

@@ -0,0 +1,17 @@
+[project]
+name = "claudia-agent"
+version = "1.4.0"
+description = "Add your description here"
+readme = "README.md"
+authors = [
+    { name = "Irae Hueck Costa", email = "mail@irae.me" }
+]
+requires-python = ">=3.13"
+dependencies = [
+    "llm>=0.31",
+    "prompt-toolkit>=3.0.52",
+    "tqdm>=4.67.3",
+]
+
+[project.scripts]
+claudia = "claudia:main"

claudia_agent-1.4.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

claudia_agent-1.4.0/src/claudia/__init__.py

@@ -0,0 +1 @@
+from .main import main

claudia_agent-1.4.0/src/claudia/constants.py

@@ -0,0 +1,46 @@
+import re
+
+
+CODEBLOCK = "\n```"
+ESCAPED_CODEBLOCK = "\n ```"
+
+# This is a marker used to detect files in llm output
+DUMMY_DIR = "github_repository"
+
+# Compiled regex for file path detection
+FILE_PATH_PATTERN = re.compile(rf"({DUMMY_DIR}/[\w/.-]+)")
+
+
+PROMPT_IMPLEMENT_TEMPLATE = """
+# Persona
+You are a senior software developer.
+
+# Project overview
+```
+{project_map}
+```
+
+# Implement
+{task}
+
+# Notes
+- Emit the whole file contents of files you want to edit as their content will be directly replaced with your content.
+- Always emmit the full file path, even when you are editing only one file.
+- Only emmit the file path and the file contents, don't reason.
+"""
+
+PROMPT_CONTEXT_TEMPLATE = """
+# Task
+List files thath are relevant to the task.
+
+## Task
+{task}
+
+## Project overview
+```
+{project_map}
+```
+
+## Notes
+- Emit the full file path including the '{dummy_dir}' prefix.
+"""

claudia_agent-1.4.0/src/claudia/main.py

@@ -0,0 +1,195 @@
+import sys
+import re
+import os
+import tempfile
+from collections import defaultdict
+import subprocess
+
+from tqdm import tqdm
+
+from . import utils
+from . import constants
+from . import models
+
+
+model = models.DeepSeekChat("deepseek-v4-flash")
+
+
+class LineHandler:
+    """Handle streaming lines from LLM output, collecting file changes."""
+
+    def __init__(self):
+        self.current_file = None
+        self.contents = defaultdict(list)
+        self.pbar = None
+
+    def get_total_lines(self, fname):
+        try:
+            with open(fname, "r") as f:
+                return len(f.readlines())
+        except FileNotFoundError:
+            return 0
+
+    def __enter__(self):
+        return self
+
+    def __call__(self, line):
+        utils.debug(f"LineHandler: {repr(line)}")
+
+        # Does the line contain a filename containing the DUMMY_DIR?
+        if match := re.search(constants.FILE_PATH_PATTERN, line):
+            fname = utils.remove_filename_prefix(match.group(1))
+            if self.current_file:
+                self.finish_current_file()
+            self.current_file = fname
+            self.pbar = tqdm(
+                desc=fname,
+                unit=" lines",
+                position=0,
+                total=self.get_total_lines(fname),
+            )
+            return
+
+        if self.current_file:
+            self.contents[self.current_file].append(line)
+            self.pbar.update()
+
+    def finish_current_file(self):
+        """Close the current progress bar and reset state."""
+        if self.pbar:
+            self.pbar.close()
+            self.pbar = None
+        self.current_file = None
+
+    def write_changes(self, dir):
+        """Write accumulated changes to the specified directory."""
+        for fname, lines in self.contents.items():
+            fname = os.path.join(dir, fname)
+            if os.sep in fname:
+                os.makedirs(os.path.dirname(fname), exist_ok=True)
+            with open(fname, "w") as f:
+                content = "\n".join(lines)
+                content = utils.unescape_codeblocks(content)
+                content = utils.trim_code_blocks_magic(fname, content)
+                f.write(content)
+
+    def preview_changes(self):
+        tmpdir = tempfile.mkdtemp(
+            suffix="  .",  # for better UX
+        )
+        self.write_changes(tmpdir)
+        subprocess.call(
+            [
+                "git",
+                "diff",
+                "--no-index",
+                ".",
+                tmpdir,
+                "--diff-filter=AM",
+            ]
+        )
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        if exc_type is not None:
+            return False
+
+        # Finish any remaining progress bar
+        if self.pbar:
+            self.pbar.close()
+
+        if self.contents:
+            self.preview_changes()
+            tqdm.write("\nPress enter to write the files...")
+            input("")
+            self.write_changes(".")
+
+            tqdm.write(f"Files changed: {', '.join(self.contents.keys())}")
+        else:
+            tqdm.write("No changes")
+
+
+def get_context_files(task):
+    """Get relevant context files for a given task from the LLM."""
+    prompt = constants.PROMPT_CONTEXT_TEMPLATE.format(
+        project_map=utils.get_project_map(),
+        task=task,
+        dummy_dir=constants.DUMMY_DIR,
+    )
+
+    response = model.prompt(prompt)
+
+    for chunk in tqdm(
+        response,
+        desc="Context files",
+        unit="tokens",
+        delay=5,
+    ):
+        pass
+
+    files = constants.FILE_PATH_PATTERN.findall(response.text())
+    fs_files = [utils.remove_filename_prefix(f) for f in files]
+    tqdm.write(f"Context: {', '.join(fs_files)}")
+    return files
+
+
+def implement(task):
+    """Main implementation flow: get context, generate code, apply changes."""
+    files = get_context_files(task)
+    fragments = utils.files_to_fragments(sorted(files))
+
+    response = model.prompt(
+        constants.PROMPT_IMPLEMENT_TEMPLATE.format(
+            task=task, project_map=utils.get_project_map()
+        ),
+        fragments=fragments,
+    )
+
+    with LineHandler() as line_handler:
+        changes = ""
+        for chunk in response:
+            changes += chunk
+            while "\n" in changes:
+                line, newline, changes = changes.partition("\n")
+                line_handler(line)
+        if changes:
+            line_handler(changes)
+
+
+def interactive_mode():
+    """Interactive REPL mode for continuous code generation."""
+    # Import here for better startup time
+    from prompt_toolkit import prompt
+    from prompt_toolkit.history import FileHistory
+
+    history = FileHistory("~/.klaus_history")
+
+    tqdm.write("Hi, specify your desired code changes (return with alt-enter)")
+    while True:
+        try:
+            user_input = prompt(
+                "> ",
+                multiline=True,
+                history=history,
+                prompt_continuation="... ",
+            )
+            implement(user_input)
+        except (EOFError, KeyboardInterrupt):
+            break
+
+
+def main():
+    if not os.environ.get("DEEPSEEK_API_KEY"):
+        print(
+            "claudia error: Please set the environment variable DEEPSEEK_API_KEY to your DeepSeek API key.",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    if len(sys.argv) > 1:
+        task = " ".join(sys.argv[1:])
+        implement(task)
+    else:
+        interactive_mode()
+
+
+if __name__ == "__main__":
+    main()

claudia_agent-1.4.0/src/claudia/models.py

@@ -0,0 +1,20 @@
+from llm.default_plugins.openai_models import Chat
+
+
+class DeepSeekChat(Chat):
+    """Custom chat handler for DeepSeek API."""
+
+    needs_key = "deepseek"
+    key_env_var = "DEEPSEEK_API_KEY"
+
+    def build_kwargs(self, prompt, stream):
+        kwargs = super().build_kwargs(prompt, stream)
+        kwargs.setdefault("extra_body", {})["thinking"] = {"type": "disabled"}
+        return kwargs
+
+    def __init__(self, model_name):
+        super().__init__(
+            model_name=model_name,
+            model_id=model_name,
+            api_base="https://api.deepseek.com",
+        )

claudia_agent-1.4.0/src/claudia/utils.py

@@ -0,0 +1,109 @@
+from tqdm import tqdm
+import functools
+import os
+import sys
+import subprocess
+from io import StringIO
+
+from .constants import DUMMY_DIR, CODEBLOCK, ESCAPED_CODEBLOCK
+
+
+def debug(text):
+    if os.environ.get("CLAUDIA_DEBUG") in ["1", "true"]:
+        tqdm.write(text)
+
+
+def escape_codeblocks(text):
+    return text.replace(CODEBLOCK, ESCAPED_CODEBLOCK)
+
+
+def unescape_codeblocks(text):
+    return text.replace(ESCAPED_CODEBLOCK, CODEBLOCK)
+
+
+def trim_code_blocks_magic(fname, content):
+    """Remove surrounding code block markers from content if present."""
+    content = content.rstrip("\n`")
+    content = content.lstrip("\n")
+
+    content_lines = content.splitlines()
+    if content_lines and content_lines[0].startswith("```"):
+        content = "\n".join(content_lines[1:])
+
+    if not content.endswith("\n"):
+        content += "\n"
+
+    return content
+
+
+def remove_filename_prefix(filename):
+    """Remove the DUMMY_DIR prefix from a filename."""
+    if filename.startswith(f"{DUMMY_DIR}/"):
+        return filename[len(f"{DUMMY_DIR}/") :]
+    return filename
+
+
+@functools.cache
+def get_project_map():
+    """Generate a map of project files and their tags using ctags."""
+    files = {}
+    try:
+        all_git_files = (
+            subprocess.check_output(
+                [
+                    "git",
+                    "ls-files",
+                    "--modified",
+                    "--cached",
+                    "--others",
+                    "--exclude-standard",
+                ],
+            )
+            .decode("utf-8")
+            .splitlines()
+        )
+    except subprocess.CalledProcessError as exc:
+        print("claudia error:", exc)
+        sys.exit(1)
+
+    # Ctags fails if a file does not exist
+    for file in list(all_git_files):
+        if not os.path.exists(file):
+            all_git_files.remove(file)
+
+    try:
+        ctags = subprocess.check_output(
+            ["ctags", "-f-"] + all_git_files, stderr=subprocess.DEVNULL
+        ).decode("utf-8")
+    except subprocess.CalledProcessError as exc:
+        print("claudia error:", exc)
+        sys.exit(1)
+
+    for line in ctags.splitlines():
+        tag, filename, *rest = line.split("\t")
+        if "/migrations/" in filename:
+            continue
+        files.setdefault(filename, []).append(tag)
+
+    files_map = StringIO()
+    for filename, tags in files.items():
+        files_map.write(f"{DUMMY_DIR}/{filename}: ")
+        files_map.write(", ".join(tags))
+        files_map.write("\n")
+
+    files_map.seek(0)
+    return files_map.read()
+
+
+def files_to_fragments(files):
+    """Read files and create fragments for the LLM."""
+    fragments = []
+    for file in files:
+        try:
+            with open(remove_filename_prefix(file), "r") as f:
+                content = f.read()
+        except FileNotFoundError:
+            fragments.append(f"# File not found: {file}")
+        else:
+            fragments.append(f"# {file}\n\n{escape_codeblocks(content)}")
+    return fragments

claudia_agent-1.4.0/src/claudia_agent.egg-info/PKG-INFO

@@ -0,0 +1,38 @@
+Metadata-Version: 2.4
+Name: claudia-agent
+Version: 1.4.0
+Summary: Add your description here
+Author-email: Irae Hueck Costa <mail@irae.me>
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: llm>=0.31
+Requires-Dist: prompt-toolkit>=3.0.52
+Requires-Dist: tqdm>=4.67.3
+Dynamic: license-file
+
+# Claudia
+
+Claudia is a command-line tool that uses DeepSeek's language models to implement code changes in your git repository based on natural language task descriptions.
+
+## Usage
+
+```bash
+export DEEPSEEK_API_KEY=your_key_here
+
+uvx claudia "Add email verification to the login form"
+
+# Interactive mode
+uvx claudia
+```
+
+## Why?
+Speed and cost. About two orders of magnitude cheaper than claude.
+
+
+## Requirements
+
+- Python 3.10+
+- A DeepSeek API key (`DEEPSEEK_API_KEY` environment variable)
+- Git
+- Universal Ctags (for project analysis)

claudia_agent-1.4.0/src/claudia_agent.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+LICENSE
+README.md
+pyproject.toml
+src/claudia/__init__.py
+src/claudia/constants.py
+src/claudia/main.py
+src/claudia/models.py
+src/claudia/utils.py
+src/claudia_agent.egg-info/PKG-INFO
+src/claudia_agent.egg-info/SOURCES.txt
+src/claudia_agent.egg-info/dependency_links.txt
+src/claudia_agent.egg-info/entry_points.txt
+src/claudia_agent.egg-info/requires.txt
+src/claudia_agent.egg-info/top_level.txt

claudia_agent-1.4.0/src/claudia_agent.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

claudia_agent-1.4.0/src/claudia_agent.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+claudia = claudia:main

claudia_agent-1.4.0/src/claudia_agent.egg-info/requires.txt

@@ -0,0 +1,3 @@
+llm>=0.31
+prompt-toolkit>=3.0.52
+tqdm>=4.67.3

claudia_agent-1.4.0/src/claudia_agent.egg-info/top_level.txt

@@ -0,0 +1 @@
+claudia