Skip to content

Add Russian translations for README and graph visualization #802

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Vasilije1990 merged 1 commit into from
May 6, 2025
Merged

Add Russian translations for README and graph visualization #802

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,10 @@ More on [use-cases](https://docs.cognee.ai/use-cases) and [evals](https://github
<a href="community/README.pt.md">🇵🇹 Português</a>
·
<a href="community/README.zh.md">🇨🇳 [中文]</a>
·
<a href="community/README.ru.md">🇷🇺 Русский</a>
</p>


<div style="text-align: center">
<img src="https://raw.githubusercontent.com/topoteretes/cognee/refs/heads/main/assets/cognee_benefits.png" alt="Why cognee?" width="50%" />
Expand Down
159 changes: 159 additions & 0 deletions community/README.ru.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,159 @@
<div align="center">
<a href="https://github.com/topoteretes/cognee">
<img src="https://raw.githubusercontent.com/topoteretes/cognee/refs/heads/dev/assets/cognee-logo-transparent.png" alt="Cognee Logo" height="60">
</a>

<br />

Cognee - это платформа для управления памятью ИИ, предназначенная для повышения точности и надежности ответов больших языковых моделей (LLM) и ИИ-агентов.

<p align="center">
<a href="https://www.youtube.com/watch?v=1bezuvLwJmw&t=2s">Демо</a>
·
<a href="https://cognee.ai">Узнать больше</a>
·
<a href="https://discord.gg/NQPKmU5CCg">Присоединиться к Discord</a>
</p>



[![GitHub forks](https://img.shields.io/github/forks/topoteretes/cognee.svg?style=social&label=Fork&maxAge=2592000)](https://GitHub.com/topoteretes/cognee/network/)
[![GitHub stars](https://img.shields.io/github/stars/topoteretes/cognee.svg?style=social&label=Star&maxAge=2592000)](https://GitHub.com/topoteretes/cognee/stargazers/)
[![GitHub commits](https://badgen.net/github.amrom.workers.devmits/topoteretes/cognee)](https://GitHub.com/topoteretes/cognee/commit/)
[![Github tag](https://badgen.net/github/tag/topoteretes/cognee)](https://github.com/topoteretes/cognee/tags/)
[![Downloads](https://static.pepy.tech/badge/cognee)](https://pepy.tech/project/cognee)
[![License](https://img.shields.io/github/license/topoteretes/cognee?colorA=00C586&colorB=000000)](https://github.com/topoteretes/cognee/blob/main/LICENSE)
[![Contributors](https://img.shields.io/github/contributors/topoteretes/cognee?colorA=00C586&colorB=000000)](https://github.com/topoteretes/cognee/graphs/contributors)

<a href="https://www.producthunt.com/posts/cognee?embed=true&utm_source=badge-top-post-badge&utm_medium=badge&utm_souce=badge-cognee" target="_blank"><img src="https://api.producthunt.com/widgets/embed-image/v1/top-post-badge.svg?post_id=946346&theme=light&period=daily&t=1744472480704" alt="cognee - Memory&#0032;for&#0032;AI&#0032;Agents&#0032;&#0032;in&#0032;5&#0032;lines&#0032;of&#0032;code | Product Hunt" style="width: 250px; height: 54px;" width="250" height="54" /></a>


Создавай динамическую память для агентов, используя ECL (Extract -> Cognify -> Load) конвейер.

Узнайте больше о [вариантах использования](https://docs.cognee.ai/use-cases) и [бенчмарках](https://github.com/topoteretes/cognee/tree/main/evals)

<div style="text-align: center">
<img src="https://raw.githubusercontent.com/topoteretes/cognee/refs/heads/main/assets/cognee_benefits.png" alt="Почему cognee?" width="50%" />
</div>

</div>



## Функциональность

- Интеграция и извлечение данных: Позволяет подключать и извлекать прошлые разговоры, документы, изображения и аудиозаписи, обеспечивая доступ к разнообразным источникам информации.

- Снижение галлюцинаций и затрат: Уменьшает вероятность генерации недостоверных ответов, снижает затраты на разработку и эксплуатацию ИИ-приложений.

- Загрузка данных с использованием Pydantic: Обеспечивает загрузку данных в графовые и векторные базы данных с использованием только Pydantic, упрощая процесс интеграции.

- Трансформация и организация данных: Позволяет трансформировать и структурировать данные, собирая их из более чем 30 различных источников, включая PDF, таблицы и другие форматы.

- Модульные ECL-пайплайны: Использует модульные пайплайны Extract, Cognify, Load (ECL) для обработки данных, что обеспечивает гибкость и масштабируемость системы.

- Поддержка онтологий на основе RDF: Использует онтологии на основе RDF для более интеллектуального управления данными и улучшения семантического понимания.

- Локальное развертывание и масштабируемость: Позволяет развернуть систему на собственных серверах, обеспечивая безопасность данных и соответствие требованиям конфиденциальности. Система масштабируется для обработки больших объемов данных.

## Начало работы

Начните легко с помощью Google Colab <a href="https://colab.research.google.com/drive/1g-Qnx6l_ecHZi0IOw23rg0qC4TYvEvWZ?usp=sharing">блокнота</a> или <a href="https://github.com/topoteretes/cognee-starter">стартового репозитория</a>

## Помощь проекту

Ваш вклад является основой для превращения этого в настоящий проект с открытым исходным кодом. Любой вклад, который вы сделаете, будет **очень приветствоваться**. Смотрите [`CONTRIBUTING.md`](/CONTRIBUTING.md) для получения дополнительной информации.

## 📦 Установка

Вы можете установить Cognee, используя **pip**, **poetry**, **uv** или любой другой менеджер пакетов Python.

### С помощью pip

```bash
pip install cognee
```

## 💻 Базовое использование

### Настройка

```python
import os
os.environ["LLM_API_KEY"] = "ВАШ_OPENAI_API_KEY"
```

Вы также можете установить переменные, создав файл .env, используя наш <a href="https://github.com/topoteretes/cognee/blob/main/.env.template">шаблон</a>.
Для использования различных провайдеров LLM смотрите нашу <a href="https://docs.cognee.ai">документацию</a>.

### Пример использования

Этот скрипт выполнит *стандартный* конвейер:

```python
import cognee
import asyncio


async def main():
# Добавляем текст в cognee
await cognee.add("Обработка естественного языка (NLP) - это междисциплинарная область компьютерных наук и информационного поиска.")

# Генерируем граф знаний
await cognee.cognify()

# Делаем поиск
results = await cognee.search("Расскажите мне о NLP")

# Отображаем результаты
for result in results:
print(result)


if __name__ == '__main__':
asyncio.run(main())

```
Пример вывода:
```
Обработка естественного языка (NLP) — это междисциплинарная область, которая объединяет компьютерные науки и информационный поиск. Она включает в себя технологии и методы обработки человеческого языка для создания интерфейсов и обработки данных.
```

Визуализация графа:
<a href="https://rawcdn.githack.com/topoteretes/cognee/refs/heads/main/assets/graph_visualization.html"><img src="graph_visualization_ru.png" width="100%" alt="Визуализация графа"></a>
[Открыть пример графа в браузере](https://rawcdn.githack.com/topoteretes/cognee/refs/heads/main/assets/graph_visualization.html).

Comment on lines +123 to +125
Copy link
Contributor

@coderabbitai coderabbitai bot May 2, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🛠️ Refactor suggestion

Ensure the graph visualization image path is correct
The src="graph_visualization_ru.png" reference is relative, but the asset likely lives under /assets. Without a full URL or correct relative path, the image won’t display.

Mirror the English README pattern:

-<a href="https://rawcdn.githack.com/topoteretes/cognee/refs/heads/main/assets/graph_visualization.html"><img src="graph_visualization_ru.png" width="100%" alt="Визуализация графа"></a>
+<a href="https://rawcdn.githack.com/topoteretes/cognee/refs/heads/main/assets/graph_visualization.html"><img src="https://raw.githubusercontent.com/topoteretes/cognee/refs/heads/main/assets/graph_visualization_ru.png" width="100%" alt="Визуализация графа"></a>

Please verify that graph_visualization_ru.png exists in the assets directory on the main branch.

📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
<a href="https://rawcdn.githack.com/topoteretes/cognee/refs/heads/main/assets/graph_visualization.html"><img src="graph_visualization_ru.png" width="100%" alt="Визуализация графа"></a>
[Открыть пример графа в браузере](https://rawcdn.githack.com/topoteretes/cognee/refs/heads/main/assets/graph_visualization.html).
<a href="https://rawcdn.githack.com/topoteretes/cognee/refs/heads/main/assets/graph_visualization.html"><img src="https://raw.githubusercontent.com/topoteretes/cognee/refs/heads/main/assets/graph_visualization_ru.png" width="100%" alt="Визуализация графа"></a>
[Открыть пример графа в браузере](https://rawcdn.githack.com/topoteretes/cognee/refs/heads/main/assets/graph_visualization.html).
🤖 Prompt for AI Agents (early access) 
In community/README.ru.md around lines 123 to 125, the image source path for the graph visualization is relative and likely incorrect. Update the src attribute to use the full relative path pointing to the assets directory, for example, src="assets/graph_visualization_ru.png", to ensure the image loads correctly. Confirm that the image file exists in the assets folder on the main branch before updating the path.


Больше примеров в <a href="https://docs.cognee.ai">документации</a>.


## Изучите нашу архитектуру

<div style="text-align: center">
<img src="https://raw.githubusercontent.com/topoteretes/cognee/refs/heads/main/assets/cognee_diagram.png" alt="концептуальная диаграмма cognee" width="100%" />
</div>

## Демонстрации

1. Что такое память ИИ:
[Видео](https://github.com/user-attachments/assets/8b2a0050-5ec4-424c-b417-8269971503f0)

2. Простая демонстрация GraphRAG
[Видео](https://github.com/user-attachments/assets/d80b0776-4eb9-4b8e-aa22-3691e2d44b8f)

3. Cognee с Ollama
[Видео](https://github.com/user-attachments/assets/8621d3e8-ecb8-4860-afb2-5594f2ee17db)

Comment on lines +138 to +146
Copy link
Contributor

@coderabbitai coderabbitai bot May 2, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Verification agent

🧩 Analysis chain

Verify demonstration video URLs
The demo section links to assets under github.com/user-attachments. Please confirm these URLs are publicly accessible and correct, or replace them with direct links in the assets/ directory.

🏁 Script executed:

#!/bin/bash
# Check HTTP status for each demo asset
urls=(
  "https://github.com/user-attachments/assets/8b2a0050-5ec4-424c-b417-8269971503f0"
  "https://github.com/user-attachments/assets/d80b0776-4eb9-4e...
  "https://github.com/user-attachments/assets/8621d3e8-ecb8-4860-afb2-5594f2ee17db"
)
for url in "${urls[@]}"; do
  if curl -I --silent "$url" | grep -q "200 OK"; then
    echo "$url is reachable"
  else
    echo "⚠️ $url is NOT reachable"
  fi
done

Length of output: 226

🏁 Script executed:

#!/bin/bash
# This script checks the HTTP status of each demo asset URL to ensure they're publicly accessible.

urls=(
  "https://github.com/user-attachments/assets/8b2a0050-5ec4-424c-b417-8269971503f0"
  "https://github.com/user-attachments/assets/d80b0776-4eb9-4b8e-aa22-3691e2d44b8f"
  "https://github.com/user-attachments/assets/8621d3e8-ecb8-4860-afb2-5594f2ee17db"
)

echo "Verifying demo video URLs..."
for url in "${urls[@]}"; do
  status=$(curl -o /dev/null -s -w "%{http_code}" "$url")
  if [[ "$status" == "200" ]]; then
    echo "✅ $url is reachable (HTTP 200)"
  else
    echo "⚠️ $url returned HTTP $status"
  fi
done

Length of output: 1503

🏁 Script executed:

#!/bin/bash
# Follow redirects and check final HTTP status and redirect targets for each demo asset URL.

urls=(
  "https://github.com/user-attachments/assets/8b2a0050-5ec4-424c-b417-8269971503f0"
  "https://github.com/user-attachments/assets/d80b0776-4eb9-4e…
  "https://github.com/user-attachments/assets/8621d3e8-ecb8-4860-afb2-5594f2ee17db"
)

echo "Following redirects and verifying final HTTP status:"
for url in "${urls[@]}"; do
  echo
  echo "URL: $url"
  # Show the redirect chain
  curl -I -s "$url" | awk '/^HTTP/{print; next} /^Location:/{print}'
  # Follow redirects and print final status
  final_status=$(curl -s -o /dev/null -w "%{http_code}" -L "$url")
  echo "Final HTTP status after redirects: $final_status"
done

Length of output: 226

Ensure demo video URLs are publicly accessible
The current links under github.com/user-attachments all return HTTP 302 (redirect to sign-in), which means they aren’t publicly reachable. Please replace them with direct, publicly accessible URLs (for example, host the video files in the repo’s assets/ directory or on a public CDN).

Affected file:

  • community/README.ru.md (lines 138–146)
🤖 Prompt for AI Agents (early access) 
In community/README.ru.md around lines 138 to 146, the demo video URLs currently point to github.com/user-attachments and return HTTP 302 redirects to sign-in pages, making them inaccessible publicly. Replace these URLs with direct links to publicly accessible locations, such as hosting the video files in the repo's assets/ directory or on a public CDN, ensuring anyone can access the demo videos without authentication.

## Правила поведения

Мы стремимся сделать открытый исходный код приятным и уважительным опытом для нашего сообщества. Смотрите <a href="/CODE_OF_CONDUCT.md"><code>CODE_OF_CONDUCT</code></a> для получения дополнительной информации.

## 💫 Контрибьюторы

<a href="https://github.com/topoteretes/cognee/graphs/contributors">
<img alt="участники" src="https://contrib.rocks/image?repo=topoteretes/cognee"/>
</a>

## История звёзд на GitHub

[![График истории звёзд](https://api.star-history.com/svg?repos=topoteretes/cognee&type=Date)](https://star-history.com/#topoteretes/cognee&Date)
Binary file added community/graph_visualization_ru.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading