# `Feline`
[🔗](https://github.com/dimamik/feline/blob/main/lib/feline.ex#L1)

Feline — Real-time voice AI pipelines for Elixir.

An Elixir reimplementation of Python's pipecat framework, leveraging
BEAM/OTP for true concurrent frame processing.

## Core Concepts

- **Frames** — Data units flowing through the pipeline (audio, text, control signals)
- **Processors** — GenServer processes that transform frames
- **Pipeline** — A chain of processors linked together
- **Services** — AI integrations (LLM, STT, TTS) implemented as processors

## Quick Start

    pipeline = Feline.Pipeline.new([
      {Feline.Services.Deepgram.STT, api_key: "...", sample_rate: 16_000},
      {Feline.Services.OpenAI.LLM, api_key: "...", model: "gpt-4.1-mini"},
      {Feline.Services.ElevenLabs.TTS, api_key: "...", voice_id: "..."}
    ])

    Feline.Pipeline.Runner.run(pipeline)

---

*Consult [api-reference.md](api-reference.md) for complete listing*