naive-knowledge-base 0.1.0__py3-none-any.whl

naive_knowledge_base-0.1.0.dist-info/METADATA

@@ -0,0 +1,215 @@
+Metadata-Version: 2.4
+Name: naive-knowledge-base
+Version: 0.1.0
+Summary: A dependency graph analyzer using smolagents
+Home-page: https://github.com/yourusername/naive-knowledge-base
+Author: Your Name
+Author-email: Your Name <your.email@example.com>
+License: MIT
+Project-URL: Homepage, https://github.com/yourusername/naive-knowledge-base
+Project-URL: Documentation, https://github.com/yourusername/naive-knowledge-base#readme
+Project-URL: Repository, https://github.com/yourusername/naive-knowledge-base
+Project-URL: Issues, https://github.com/yourusername/naive-knowledge-base/issues
+Keywords: dependency-graph,code-analysis,smolagents,ai-agents
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# Naive Knowledge Base
+
+A dependency graph analyzer using smolagents for building and analyzing code dependencies.
+
+## Features
+
+- 🔍 **Dependency Graph Generation**: Automatically generate dependency graphs from source code
+- 🤖 **AI-Powered Analysis**: Uses smolagents for intelligent code analysis
+- 📊 **Multiple Language Support**: Support for Java and other languages
+- 🌳 **Directory Tree Visualization**: Generate visual representations of project structure
+- 📝 **File Operations**: Read, write, and manage files programmatically
+
+## Installation
+
+### From Source
+
+```bash
+git clone https://github.com/yourusername/naive-knowledge-base.git
+cd naive-knowledge-base
+pip install -e .
+```
+
+### From PyPI (when published)
+
+```bash
+pip install naive-knowledge-base
+```
+
+## Requirements
+
+- Python 3.8+
+- OpenAI API key (or compatible API)
+
+## Configuration
+
+Create a `.env` file in your project directory with the following:
+
+```env
+OPENAI_API_KEY=your_api_key_here
+# Or configure your API endpoint
+API_BASE_URL=your_api_base_url
+```
+
+## Usage
+
+### Command Line Interface
+
+After installation, you can use the `naive-kb` command:
+
+```bash
+# Basic usage
+naive-kb /path/to/source/directory
+
+# Specify file extensions
+naive-kb /path/to/source/directory java
+
+# Specify directories to ignore
+naive-kb /path/to/source/directory java "target,.git,test,node_modules"
+```
+
+### Python API
+
+```python
+from naive_knowledge_base import run_analysis
+
+# Run dependency graph analysis
+result = run_analysis(
+    source_directory="/path/to/source",
+    file_extensions="java",
+    ignore_dirs="target,.git,test"
+)
+```
+
+### Advanced Usage
+
+```python
+from smolagents import CodeAgent, ToolCallingAgent
+from naive_knowledge_base.api_models import FlowApiModel
+from naive_knowledge_base.tools import (
+    save_content_to_file,
+    read_file_content,
+    delete_folder_or_file,
+    generate_folder_tree
+)
+from naive_knowledge_base.agents.dependency_graph import generate_dependency_graph
+
+# Create custom agents
+model = FlowApiModel(model_id="gpt-4.1", temperature=0.5)
+
+dependency_agent = ToolCallingAgent(
+    tools=[generate_dependency_graph],
+    model=model,
+    max_steps=7,
+    name="dependency_graph_agent"
+)
+
+manager_agent = CodeAgent(
+    managed_agents=[dependency_agent],
+    model=model,
+    tools=[read_file_content, save_content_to_file],
+    max_steps=30,
+    name="tech_lead_agent"
+)
+
+# Run analysis
+result = manager_agent.run("Analyze dependencies in /path/to/source")
+```
+
+## Package Structure
+
+```
+naive_knowledge_base/
+├── agents/
+│   ├── common/          # Common agent utilities
+│   │   ├── base.py
+│   │   ├── exceptions.py
+│   │   ├── logging.py
+│   │   └── utils.py
+│   └── dependency_graph/  # Dependency graph analysis
+│       ├── agent.py
+│       └── model.py
+├── api_models/          # API model integrations
+│   └── flow_api_model.py
+└── tools/              # Agent tools
+    ├── io.py           # File I/O operations
+    └── tree.py         # Directory tree generation
+```
+
+## Development
+
+### Setup Development Environment
+
+```bash
+# Clone the repository
+git clone https://github.com/yourusername/naive-knowledge-base.git
+cd naive-knowledge-base
+
+# Create virtual environment
+python -m venv venv
+source venv/bin/activate  # On Windows: venv\Scripts\activate
+
+# Install in editable mode with dev dependencies
+pip install -e ".[dev]"
+```
+
+### Running Tests
+
+```bash
+pytest tests/
+```
+
+### Code Formatting
+
+```bash
+# Format code
+black .
+isort .
+
+# Check code quality
+pylint naive_knowledge_base/
+```
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
+3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
+4. Push to the branch (`git push origin feature/AmazingFeature`)
+5. Open a Pull Request
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE file for details.
+
+## Acknowledgments
+
+- Built with [smolagents](https://github.com/huggingface/smolagents)
+- Uses OpenAI API for AI-powered analysis
+
+## Support
+
+For issues and questions, please file an issue on the [GitHub repository](https://github.com/yourusername/naive-knowledge-base/issues).

naive_knowledge_base-0.1.0.dist-info/RECORD

@@ -0,0 +1,24 @@
+cli.py,sha256=ZqBfGleriD2imzWhbV7noEz2IBClE2sRzRDG9hmygXk,5782
+main.py,sha256=AjFqJ-BAXUxeK31kuQOL_tkGW1w7WhgsS_HS5eqheXk,2219
+agents/__init__.py,sha256=5M5g7jPBn9PeMJ9TwH2Yggq0SqWY95rSnD8NWZm0cXY,151
+agents/common/__init__.py,sha256=9iwI7BZR8GqRlRD-Fvq42fW52SAZt3oUM2e0hR1bXW4,563
+agents/common/base.py,sha256=m8o2HQ6Q0sTpbjxIoNV9amuXE3wPzgN2QHqKflOBmNk,5083
+agents/common/exceptions.py,sha256=QilIzsJHLShZ8i1ZDRpWT6KRhSG5CJVSwynbHTO3-6I,2130
+agents/common/logging.py,sha256=ZinsduEU6PUwPwy8yzITCn-4EZE5j7_6b206sV90fHk,1868
+agents/common/schema_converter.py,sha256=sFGFngQpFwPAAbjcVbqFfGifXKXN4iZZiun4oz9fFgs,4401
+agents/common/tools.py,sha256=zsHPqDkuHQJjO8rmqo0XRCFP4OCeyXWDnUPExMAhY7U,5358
+agents/common/utils.py,sha256=gcjfYERYWc8cRNm3BYcaOsxsrGXb4mZQiwGIuO20u1g,4628
+agents/dependency_graph/__init__.py,sha256=an4MdRnl5JJUhw4FCfvRvjHyozxy8DowVetOlrhZ5qw,149
+agents/dependency_graph/agent.py,sha256=RyOgA7VqcYKIV_2OKGVajhcQnbc51shumrHYs62UkyM,7292
+agents/dependency_graph/model.py,sha256=fMA4iXphVZQ41UcrgWHpp_hdUFaLY4_8-6QVaTU4o44,1098
+api_models/__init__.py,sha256=iPxcX-RpouvXZFmwbH-SeUWhW4UQBe8a-l2DmC2csrM,96
+api_models/flow_api_model.py,sha256=aSmsY0TRHB8Ylisbk8-CzB4CBo8QwAZJRLmiIa6nx6s,15184
+naive_knowledge_base-0.1.0.dist-info/licenses/LICENSE,sha256=OphKV48tcMv6ep-7j-8T6nycykPT0g8ZlMJ9zbGvdPs,1066
+tools/__init__.py,sha256=RUzn2bV-Q7GJrx6jy-Vo3j_5kBlJH9GTv9ZK3Z-hKGE,271
+tools/io.py,sha256=MfRJMbIjYx54iNq4nit5jVjXZqjPktg9m7RI_gCxHWo,1612
+tools/tree.py,sha256=rUv5Qm4PZW7-zxD3S8e_PFj5PliAA5XdTJyqF8L42nk,1666
+naive_knowledge_base-0.1.0.dist-info/METADATA,sha256=AP65NDms9-h53diiSEdhnFLMOQfrNgA4rZUPZtCP0t4,5676
+naive_knowledge_base-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+naive_knowledge_base-0.1.0.dist-info/entry_points.txt,sha256=UgKAmqSs86uLJ3P81eLHEauN-RWaGFT0uhZ54mTzvqo,38
+naive_knowledge_base-0.1.0.dist-info/top_level.txt,sha256=QLdDlcaSJKlVrg-wXEyzw4dfOnxkVaXP02og9vzF5aU,33
+naive_knowledge_base-0.1.0.dist-info/RECORD,,

naive_knowledge_base-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

naive_knowledge_base-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+naive-kb = cli:main

naive_knowledge_base-0.1.0.dist-info/licenses/LICENSE

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

naive_knowledge_base-0.1.0.dist-info/top_level.txt

@@ -0,0 +1,5 @@
+agents
+api_models
+cli
+main
+tools

tools/__init__.py

@@ -0,0 +1,11 @@
+from .io import save_content_to_file
+from .io import delete_folder_or_file
+from .io import read_file_content
+from .tree import generate_folder_tree
+
+__all__ = [
+    "save_content_to_file",
+    "delete_folder_or_file",
+    "read_file_content",
+    "generate_folder_tree"
+]

tools/io.py

@@ -0,0 +1,59 @@
+from smolagents.tools import tool
+import os
+from pathlib import Path
+import shutil
+
+@tool
+def delete_folder_or_file(absolute_path: str) -> bool:
+    """
+    Deletes a folder or file.
+    
+    Args:
+        absolute_path (str): The path to the folder or file to delete.
+    Returns:
+       bool: True if the deletion was successful, False otherwise.
+    """
+    path = Path(absolute_path).resolve()
+
+    if path.is_dir():
+        shutil.rmtree(path)
+    elif path.is_file():
+        os.remove(path)
+    else:
+        return False
+
+    return  True
+
+@tool
+def save_content_to_file(content: str, source_directory: str, file_name: str) -> str:
+    """
+    Saves the given content to a file.
+    
+    Args:
+        content (str): The content to be saved.
+        source_directory (str): The directory where the file will be saved.
+        file_name (str): The name of the file where the content will be saved.
+    Returns:
+        str: The full path of the saved file.
+    """
+    knolwledge_base_dir = f"{source_directory}/knowledge_base/{file_name}"
+    file_path_obj = Path(knolwledge_base_dir).resolve()
+    file_path_obj.parent.mkdir(parents=True, exist_ok=True)
+    with open(file_path_obj, "w") as file:
+        file.write(content)
+
+    return str(file_path_obj)
+
+@tool
+def read_file_content(absolute_file_path: str) -> str:
+    """
+    Reads the content of a dependency.
+    
+    Args:
+        absolute_file_path (str): The path to the file to read.
+    Returns:
+        str: The content of the file.
+    """
+    file_path = Path(absolute_file_path).resolve()
+
+    return file_path.read_text(encoding="utf-8")

tools/tree.py

@@ -0,0 +1,42 @@
+from smolagents import tool
+import os
+from tools import save_content_to_file, delete_folder_or_file
+from directory_tree import DisplayTree
+
+@tool
+def generate_folder_tree(source_directory: str, ignore_directories_containing: list[str]) -> str:
+    """
+    Generates a folder tree for the given source directory.
+    Args:
+        source_directory: The source directory to analyze.
+        permit_file_extensions: The file extensions to permit in the analysis.
+        ignore_directories_containing: The directories to ignore in the analysis.
+    Returns:
+        str: The folder tree file path.
+    Raises:
+        ValueError: If the source directory does not exist or is not a directory.
+    """
+    # Check if the source directory exists
+    if not os.path.exists(source_directory):
+        raise ValueError(f"Source directory does not exist: {source_directory}")
+
+    # Check if the source directory is a directory
+    if not os.path.isdir(source_directory):
+        raise ValueError(f"Source path is not a directory: {source_directory}")
+
+    # Generate the folder tree
+    tree = DisplayTree(
+        dirPath=source_directory,
+        stringRep=True,
+        ignoreList=ignore_directories_containing if 'ignore_directories_containing' in locals() else None
+    )
+    folder_tree_str = f"# Folder Structure:\n\n```\n{tree}\n```\n\n## Dependency Graph\n\nFor detailed component and module dependencies, see [dependency_graph.toon](dependency_graph.toon)"
+
+    # Save the folder tree to a file
+    file_path = save_content_to_file(
+        content=folder_tree_str,
+        source_directory=source_directory,
+        file_name="brief.md"
+    )
+
+    return file_path