Skip to content

ACKNOWLEDGEMENTS.md

Latest commit

 

History

History
221 lines (140 loc) · 10.3 KB

ACKNOWLEDGEMENTS.md

File metadata and controls

221 lines (140 loc) · 10.3 KB

Acknowledgements

The Empathy Framework stands on the shoulders of giants. This project would not be possible without the incredible work of the open source community. We are deeply grateful to all the developers, maintainers, and contributors of the projects listed below.

Core Framework Dependencies

Python Type System & Validation

  • Pydantic - Data validation using Python type annotations. The foundation of our configuration and model validation system.
  • typing-extensions - Backported and experimental type hints for Python.

Configuration & Environment

  • python-dotenv - Reads key-value pairs from .env files and sets them as environment variables.
  • PyYAML - YAML parser and emitter for Python. Used for workflow configuration.
  • defusedxml - XML bomb protection for Python stdlib modules.

Logging & CLI

  • structlog - Structured logging for Python. Makes logs readable, parseable, and debuggable.
  • rich - Beautiful formatting in the terminal. Powers our progress bars and formatted output.
  • typer - Modern CLI framework based on Python type hints. Makes our CLI intuitive and self-documenting.

AI & LLM Integration

LLM Providers

Agent Frameworks

  • LangChain - Framework for developing applications powered by language models. Used for our agent workflows.
  • LangGraph - Library for building stateful, multi-actor applications with LLMs. Powers our meta-orchestration.
  • LangChain Core - Core abstractions and runtime for LangChain.
  • LangChain Text Splitters - Text splitting utilities for LangChain.

Semantic Search & Embeddings

  • Sentence Transformers - Multilingual sentence embeddings. Powers our semantic caching and similarity search.
  • PyTorch - Deep learning framework. Required for sentence transformers.
  • NumPy - Fundamental package for scientific computing with Python.

Memory & Storage

  • MemDocs - Long-term memory system for AI agents. Provides persistent context across sessions.
  • Redis - Python client for Redis. Powers our short-term memory and agent coordination.

Web Framework & API

  • FastAPI - Modern, fast web framework for building APIs with Python. Powers our backend API.
  • Uvicorn - Lightning-fast ASGI server. Runs our FastAPI applications.
  • Starlette - Lightweight ASGI framework/toolkit. Foundation of FastAPI.
  • HTTPX - Next generation HTTP client for Python. Used in our test suite.

Security & Authentication

  • bcrypt - Modern password hashing for your software and your servers.
  • PyJWT - JSON Web Token implementation in Python. Used for authentication tokens.
  • cryptography - Python cryptography library. Required by PyJWT for advanced algorithms.
  • marshmallow - Object serialization/deserialization library. Used for secure data validation.

Observability & Telemetry

Developer Tools

Code Quality

  • Black - The uncompromising Python code formatter. Keeps our code consistent.
  • Ruff - An extremely fast Python linter, written in Rust. Replaces dozens of linting tools.
  • mypy - Static type checker for Python. Catches type errors before runtime.
  • Bandit - Security linter for Python. Finds common security issues.
  • pre-commit - Framework for managing git pre-commit hooks. Enforces quality standards.

Testing

  • pytest - Python testing framework. Makes writing tests simple and scalable.
  • pytest-asyncio - Pytest plugin for testing asyncio code.
  • pytest-cov - Coverage plugin for pytest. Tracks test coverage.
  • pytest-xdist - Parallel test execution for pytest. Makes test runs 4-8x faster.
  • pytest-testmon - Selects tests affected by recent changes. Speeds up development.
  • pytest-picked - Runs tests related to unstaged files. Perfect for rapid iteration.
  • coverage.py - Code coverage measurement for Python.

Documentation

Editor Integration

  • pygls - Pythonic Language Server Protocol implementation. Powers our LSP server.
  • lsprotocol - Types and classes for Language Server Protocol.

Platform Compatibility

  • colorama - Cross-platform colored terminal text. Makes Windows terminals beautiful.

Document Processing

  • python-docx - Creates and updates Microsoft Word (.docx) files. Used in document generation workflows.

Special Thanks

We extend our deepest gratitude to:

Major Frameworks & Standards

  • Python Software Foundation - For creating and maintaining the Python programming language.
  • Anthropic - For Claude AI and the Model Context Protocol (MCP) specification.
  • OpenAI - For pioneering work in large language models and API standards.
  • The Rust Foundation - For Rust, which powers Ruff and many performance-critical tools.

Community Projects

  • PyPI - The Python Package Index, making package distribution effortless.
  • GitHub - For hosting our repository and enabling collaboration.
  • Read the Docs - For free documentation hosting for open source projects.

Individual Contributors

We are grateful to all contributors who have submitted issues, pull requests, documentation improvements, and bug reports. Your contributions make this project better every day.

Contributing Acknowledgements

If you contribute to this project and use open source libraries, please update this file to include proper attribution. Follow these guidelines:

  1. Add the library to the appropriate section above
  2. Include a link to the project's homepage or GitHub repository
  3. Provide a brief description (1-2 sentences) of what the library does and how we use it
  4. Verify the license is compatible with Apache 2.0 (see LICENSE)

How to Add an Acknowledgement

When adding a new dependency:

# 1. Add to pyproject.toml (already done when you installed it)

# 2. Add to this ACKNOWLEDGEMENTS.md file
# Format:
# - **[Project Name](https://github.com/org/repo)** - Brief description of what it does and how we use it.

# 3. Verify license compatibility
pip-licenses --from=mixed --format=markdown > licenses.md

License Compatibility

All dependencies listed here are compatible with the Apache License 2.0 under which Empathy Framework is distributed. Common compatible licenses include:

  • MIT License
  • Apache License 2.0
  • BSD Licenses (2-Clause, 3-Clause)
  • Python Software Foundation License
  • ISC License

For detailed license information on each dependency, run:

pip install pip-licenses
pip-licenses --from=mixed --format=markdown

Questions?

If you notice a missing attribution or have questions about licensing:

Last Updated: January 29, 2026 Empathy Framework Version: 5.1.1

"If I have seen further, it is by standing on the shoulders of giants." — Isaac Newton

Thank you to everyone who contributes to open source software. Your generosity makes projects like this possible.