> ## Documentation Index
> Fetch the complete documentation index at: https://typecast.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Fix common CLI installation, authentication, and playback issues.

<AccordionGroup>
  <Accordion title="cast: command not found">
    * Verify the installation completed successfully.
    * Homebrew: run `brew list neosapience/tap/cast`.
    * Go: ensure `$GOPATH/bin` is in your `PATH`.
    * Open a new terminal session after installing.
  </Accordion>

  <Accordion title="Authentication error">
    * Run `cast login` to re-enter your API key.
    * Verify your key in the [Typecast API Console](https://typecast.ai/developers/api).
    * Run `cast logout`, then `cast login` to reset local credentials.
  </Accordion>

  <Accordion title="No audio playback">
    * Save to a file instead: `cast "test" --out test.wav`.
    * Check your system audio output device.
    * Ensure your system volume is not muted.
  </Accordion>
</AccordionGroup>

## Resources

<CardGroup cols={2}>
  <Card title="GitHub" icon="github" href="https://github.com/neosapience/cast">
    Source code and releases.
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference">
    Explore the Typecast API.
  </Card>

  <Card title="Voice Library" icon="microphone" href="https://typecast.ai/developers/api/voices">
    Browse available voices.
  </Card>

  <Card title="Typecast API Console" icon="globe" href="https://typecast.ai/developers/api">
    Manage API keys and settings.
  </Card>
</CardGroup>
