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

# Установка

> Как установить и настроить Ziva в вашем Go проекте

# Установка Живаа

## Требования

* **Go 1.23.0+** (рекомендуется toolchain 1.24.5)
* Терминал с поддержкой UTF-8 для корректного отображения псевдографики
* Поддержка цветов в терминале (опционально)

## Установка

### Через go get

```bash theme={null}
go get github.com/qzeleza/ziva
```

### Через go mod

Добавьте в ваш `go.mod`:

```go theme={null}
require github.com/qzeleza/ziva latest
```

Затем выполните:

```bash theme={null}
go mod tidy
```

## Проверка установки

Создайте простой файл `main.go` для проверки:

```go theme={null}
package main

import (
    "fmt"
    "log"
    "github.com/qzeleza/ziva"
)

func main() {
    // Создаем простую задачу
    task := ziva.NewYesNoTask("Тест", "Ziva установлен корректно?")

    // Создаем очередь и добавляем задачу
    queue := ziva.NewQueue("Проверка установки Ziva")
    queue.AddTasks(task)

    // Запускаем
    if err := queue.Run(); err != nil {
        log.Fatal(err)
    }

    // Проверяем результат
    if task.IsYes() {
        fmt.Println("✅ Отлично! Ziva готов к работе.")
    } else {
        fmt.Println("❌ Нужно проверить установку.")
    }
}
```

Запустите:

```bash theme={null}
go run main.go
```

## Настройка окружения

### Настройка локали (для русского языка)

Для корректного отображения русского текста настройте локаль:

**Ubuntu/Debian:**

```bash theme={null}
sudo locale-gen ru_RU.UTF-8
sudo update-locale LANG=ru_RU.UTF-8
export LANG=ru_RU.UTF-8
export LC_ALL=ru_RU.UTF-8
```

**Entware/BusyBox:**

```bash theme={null}
opkg install locale-full glibc-binary-locales
export LANG=ru_RU.UTF-8
```

### Настройка шрифта

Для встроенных систем может потребоваться настройка шрифта:

```bash theme={null}
setterm -reset
setterm -store
setterm -font latarcyrheb-sun32  # для Cyrillic
```

### Переменные окружения

Ziva поддерживает настройку через переменные окружения:

```bash theme={null}
# Язык интерфейса
export ZIVA_LANG=ru
export ZIVA_DEFAULT_LANG=ru

# Для встроенных систем
export ZIVA_MEMORY_PRESSURE_THRESHOLD=50M
export ZIVA_MAX_COMPLETED_TASKS=10

# Цвета терминала
export COLORTERM=truecolor
export TERM=xterm-256color
```

## Структура проекта

Рекомендуемая структура Go проекта с Ziva:

```go theme={null}
myapp/
├── go.mod
├── go.sum
├── main.go
├── cmd/
│   └── myapp/
│       └── main.go
├── internal/
│   ├── tasks/
│   ├── config/
│   └── ui/
└── pkg/
    └── validation/
```

## Зависимости

Ziva использует следующие основные зависимости:

* **Bubble Tea** - основа для TUI
* **Lip Gloss** - стилизация и цвета
* \*\*Testify \*\*- тестирование пакета

Все зависимости устанавливаются автоматически при `go get`.

<Card title="Следующий шаг" icon="arrow-right" href="/ru/quick-start">
  Создайте ваше первое TUI приложение
</Card>