# Blue Oyster Personal Companion

## Docs

- [Generate Response](https://docs.oyester.metaphy.live/api/generate.md): Generate a non-streaming response from the companion agent
- [Speech-to-Text](https://docs.oyester.metaphy.live/api/speech-to-text.md): Transcribe audio files to text using OpenAI Whisper
- [Stream Response](https://docs.oyester.metaphy.live/api/stream.md): Generate a streaming response from the companion agent using Server-Sent Events
- [Authentication](https://docs.oyester.metaphy.live/authentication.md): Authentication and authorization for the Blue Oyster API
- [Introduction](https://docs.oyester.metaphy.live/introduction.md): Welcome to the Blue Oyster Personal Companion API documentation
- [Friend Personality](https://docs.oyester.metaphy.live/personalities/friend.md): Warm, empathetic support for everyday spiritual growth
- [Guru Personality](https://docs.oyester.metaphy.live/personalities/guru.md): Ancient wisdom and profound spiritual guidance
- [Personalities Overview](https://docs.oyester.metaphy.live/personalities/overview.md): Learn about the four distinct personality modes of the Blue Oyster companion
- [Philosopher Personality](https://docs.oyester.metaphy.live/personalities/philosopher.md): Intellectual inquiry and critical analysis of spiritual concepts
- [Wanderer Personality](https://docs.oyester.metaphy.live/personalities/wanderer.md): Adventurous exploration and spiritual journey narratives
- [Quick Start](https://docs.oyester.metaphy.live/quick-start.md): Get started with the Blue Oyster API in minutes
- [Best Practices](https://docs.oyester.metaphy.live/reference/best-practices.md): Guidelines for building robust applications with the Blue Oyster API
- [Error Handling](https://docs.oyester.metaphy.live/reference/error-handling.md): Comprehensive guide to handling API errors and implementing robust error recovery
- [Examples](https://docs.oyester.metaphy.live/reference/examples.md): Complete integration examples and code samples for the Blue Oyster API
- [Response Formats](https://docs.oyester.metaphy.live/reference/response-formats.md): Detailed breakdown of API response structures and data formats
- [Destinations Tool](https://docs.oyester.metaphy.live/tools/destinations.md): Discover spiritual destinations from the curated database
- [Meditation Audio Tool](https://docs.oyester.metaphy.live/tools/meditation-audio.md): Discover and play meditation, ambient, and spiritual audio tracks
- [Weather Tool](https://docs.oyester.metaphy.live/tools/weather.md): Get current weather information for meditation and travel planning

## OpenAPI Specs

- [openapi](https://docs.oyester.metaphy.live/api-reference/openapi.json)