Skip to content

Contributing

How to Contribute

Contributions are welcome! Please feel free to submit issues or pull requests on GitHub.

Development Setup

git clone https://github.com/ken11/tokuye.git
cd tokuye

# Install dependencies including dev extras
uv sync --extra dev

# Run linter
uv run ruff check src/

# Run formatter
uv run ruff format src/

# Run tests
uv run pytest

License

MIT License — see LICENSE file for details.

Acknowledgments

Tokuye builds upon the excellent work of several open-source projects.

Core Dependencies

  • Strands Agents — AWS AI Agent Framework that powers Tokuye's agent architecture
  • Textual — Beautiful TUI framework for the interactive terminal interface

Code Attribution

Portions of Tokuye's code are derived from or inspired by the following MIT-licensed projects:

  • langchain-community (MIT License, LangChain)
  • File management toolkit (file_management.py)
  • Code segmentation and tree-sitter-based parsing (repo_summary_rag/languages/)

  • See NOTICE.md for detailed attribution

  • langchain (MIT License, LangChain)

  • Recursive text splitter with offset tracking (repo_summary_rag/splitter.py)
  • Based on libs/text-splitters/langchain_text_splitters/character.py

  • See NOTICE.md for detailed attribution

  • Repomix (MIT License)

  • Repository summarization approach (repo_summary.py)
  • Inspiration for Claude-friendly XML output format
  • See NOTICE.md for detailed attribution

All derived code has been modified and adapted for Tokuye's architecture and requirements. We are grateful to the maintainers and contributors of these projects for making their work available under permissive licenses.

For complete license texts and detailed attribution, see NOTICE.md.