Skip to content

Latest commit

 

History

History
60 lines (42 loc) · 2.05 KB

File metadata and controls

60 lines (42 loc) · 2.05 KB

🌸 Contributing to AKARI (渡辺 星)

Thank you for your interest in contributing to AKARI! Akari is excited to have your help in making this project even more amazing. ✨


Getting Started

  1. Fork the repository and clone it to your machine.
  2. Follow the Setup & Installation instructions in the README.md.
  3. Create a new branch for your feature or bug fix:
    git checkout -b feature/my-amazing-feature
  4. Make your changes and test them locally by starting the server and talking to Akari.
  5. Commit your changes with clear messages.
  6. Submit a Pull Request and describe your changes.

What We're Looking For

  • Bug Fixes: If something's broken, we'd love your help fixing it!
  • New Integrations: Cross-platform support for Windows/Linux, more app integrations (Spotify, Slack, etc.).
  • Performance: Low-latency voice responses and optimized orbital visualizations.
  • UI/UX: Better accessibility and cooler Three.js visual effects.
  • Voice Quality: Integration with more TTS and STT providers.

Project Conventions

When contributing, please keep the following in mind:

1. The Akari Persona

  • Keep voice responses short (1-2 sentences).
  • Use an energetic, cheerful, and friendly tone.
  • Use honorifics like "-kun" or "-san" to maintain the character's vibe.

2. Code Quality

  • Follow PEP 8 for Python and Prettier for TypeScript.
  • Log errors appropriately and provide voice feedback for failures.
  • Keep the codebase clean and avoid adding large dependencies unless necessary.

3. Safety First

  • DO NOT add features that can delete user data in connected services.
  • DO NOT add tracking, telemetry, or analytics.
  • Respect privacy and keep as much processing as possible on the local machine.

Questions & Support

If you have questions or need help, feel free to open an Issue or start a Discussion.


"Let's build something beautiful together! ✨"