добавил языки

README.md

@@ -11,6 +11,43 @@ license: mit
 ---
 
 # 🧙🌀 Fantasy Characters Explorer  
+# English
+**Interactive Character Library for RPGs and Inspiration**  
+
+[![Open in Spaces](https://img.shields.io/badge/🤗-Open%20in%20Spaces-blue)](https://huggingface.co/spaces/loim/ru_fantasy_characters_explorer)
+[![Dataset](https://img.shields.io/badge/🗃️-Original_Dataset-ff69b4)](https://huggingface.co/datasets/loim/ru_fantasy_characters)  
+
+## ✨ Features  
+- **Search** by name, description, or tags  
+- **Filters**: absurdity, mood, tags  
+- **RPG character cards** in Markdown (one-click copy)  
+- **Sorting** by name/absurdity level  
+- Atmospheric design  
+
+## 🎮 How to Use  
+1. Apply filters  
+2. Click on a character to expand details  
+3. Copy the RPG-ready code
+4. Get inspired and craft stories!  
+
+## 🗝️ Example Character  
+```markdown
+**Name:** Каландра Сольна Губа  
+**World:** Омут Шепчущих Волн — океан, где вода тверже стали...  
+**Mood:** Мрачный  
+**Absurdity:** 7/10  
+
+**Description:** Женщина с чешуйчатой кожей цвета шторма...  
+> *«Твой корабль... уже дал течь...»*
+```
+
+## 🛠️ Technologies  
+`Python` · `Streamlit` · `Hugging Face Datasets`  
+
+---  
+🔮 *Created for those who seek magic in the details*  
+
+# Русский
 **Интерактивная библиотека персонажей для RPG и вдохновения**  
 
 [![Open in Spaces](https://img.shields.io/badge/🤗-Open%20in%20Spaces-blue)](https://huggingface.co/spaces/loim/ru_fantasy_characters_explorer)
@@ -26,7 +63,7 @@ license: mit
 ## 🎮 Как использовать
 1. Выберите фильтры
 2. Нажмите на персонажа, чтобы раскрыть детали
-3. Скопируйте код для RPG-сессий через иконку 📋
+3. Скопируйте код для RPG-сессий
 4. Вдохновляйтесь и создавайте истории!
 
 ## 🗝️ Пример персонажа

app.py

@@ -1,26 +1,42 @@
 import streamlit as st
-from data_loader import load_data, get_unique_mood, get_unique_tags
+from streamlit_cookies_controller import CookieController
 from utils import apply_filters
+from locales import load_locale, lang_codes
+from data_loader import load_data, get_unique_mood, get_unique_tags
 from ui_components import render_sidebar, render_main_content, load_css
+import time
+
+DEFAULT_LANG = "en"
+
 
 # Настройки страницы
 st.set_page_config(layout="wide", page_icon="🧙", page_title="Fantasy Characters Explorer")
+cookie = CookieController()
 
 # Загрузка данных
 df = load_data()
 
+st.session_state.lang = cookie.get("lang")
+all_langs = lang_codes()
+if st.session_state.lang not in all_langs:
+    st.session_state.lang = (st.context.locale.split("-", 1)[0] if st.context.locale else DEFAULT_LANG)
+    cookie.set("lang", st.session_state.lang)
+
+locale = load_locale(st.session_state.lang)
+
 # Загрузка стилей
 st.markdown(f"<style>{load_css()}</style>", unsafe_allow_html=True)
 
 # Получение уникальных значений для фильтров
-moods = ["Все"] + get_unique_mood(df)
+moods = [locale["filter_all"]] + get_unique_mood(df)
 all_tags = get_unique_tags(df)
 
 # Рендеринг сайдбара с фильтрами
-selected_filters = render_sidebar(moods, all_tags)
+selected_filters = render_sidebar(cookie, locale, all_langs, moods, all_tags)
 
 # Применение фильтров
 filtered_df = apply_filters(
+    locale,
     df=df,
     search_query=selected_filters["search_query"],
     absurdity_range=selected_filters["absurdity_range"],
@@ -30,4 +46,4 @@ filtered_df = apply_filters(
 )
 
 # Основной контент
-render_main_content(filtered_df)
+render_main_content(locale, filtered_df)

locales.py

@@ -0,0 +1,19 @@
+import json
+from pathlib import Path
+import streamlit as st
+
+locales_dir = Path("locales")
+
+@st.cache_data
+def lang_codes():
+	return [l.stem for l in locales_dir.glob("*.json")]
+
+@st.cache_data
+def load_locale(lang):
+	locale = {}
+
+	locale_dir = locales_dir / f"{lang}.json"
+	with open(locale_dir, "r", encoding="utf-8") as f:
+		locale = json.load(f)
+
+	return locale

locales/en.json

@@ -0,0 +1,32 @@
+{
+	"filter_lang": "Languages",
+	"filter_all": "All",
+	"filter_title": "🔮 Filters",
+	"filter_search": "🔍 Search by name/description",
+	"filter_sort_title": "Sorting",
+	"filter_sort": ["By name (A→Z)", "By name (Z→A)", "By absurdity (↑)", "By absurdity (↓)"],
+	"filter_absurd": "Absurdity level",
+	"filter_mood": "Mood",
+	"filter_tags": "Tags",
+	"main_not_found": "No characters found. Try adjusting the filters.",
+	"main_counter": "Characters per page",
+	"main_page": "Page",
+	"main_found": "**Characters found:** {} (Page {}/{})",
+	"pages_first": "⏪ First",
+	"pages_before": "◀️ Back",
+	"pages_next": "Next ▶️",
+	"pages_last": "Last ⏩",
+	"char_world": "🌍 World:",
+	"char_mood": "🎭 Mood:",
+	"char_absurd": "🌀 Absurdity:",
+	"char_tags": "🏷️ Tags:",
+	"char_desc": "📖 Description:",
+	"char_style": "💬 Speech style:",
+	"char_rpg_card": "📋 RPG card",
+	"rpt_card_world": "World:",
+	"rpt_card_name": "Name:",
+	"rpt_card_desc": "Appearance:",
+	"rpt_card_story": "Personality:",
+	"rpt_card_style": "Speech:",
+	"rpt_card_msg": "First message:"
+}

locales/ru.json

@@ -0,0 +1,32 @@
+{
+	"filter_lang": "Языки",
+	"filter_all": "Все",
+	"filter_title": "🔮 Фильтры",
+	"filter_search": "🔍 Поиск по имени/описанию",
+	"filter_sort_title": "Сортировка",
+	"filter_sort": ["По имени (А→Я)", "По имени (Я→А)", "По абсурдности (↑)", "По абсурдности (↓)"],
+	"filter_absurd": "Уровень абсурдности",
+	"filter_mood": "Настроение",
+	"filter_tags": "Теги",
+	"main_not_found": "Персонажи не найдены. Попробуйте изменить фильтры.",
+	"main_counter": "Персонажей на странице",
+	"main_page": "Страница",
+	"main_found": "**Найдено персонажей:** {} (Страница {}/{})",
+	"pages_first": "⏪ Начало",
+	"pages_before": "◀️ Назад",
+	"pages_next": "Вперед ▶️",
+	"pages_last": "Конец ⏩",
+	"char_world": "🌍 Мир:",
+	"char_mood": "🎭 Настроение:",
+	"char_absurd": "🌀 Абсурдность:",
+	"char_tags": "🏷️ Теги:",
+	"char_desc": "📖 Описание:",
+	"char_style": "💬 Стиль речи:",
+	"char_rpg_card": "📋 RPG-карточка",
+	"rpt_card_world": "Мир:",
+	"rpt_card_name": "Имя:",
+	"rpt_card_desc": "Внешность:",
+	"rpt_card_story": "Характер:",
+	"rpt_card_style": "Речь:",
+	"rpt_card_msg": "Первая реплика:"
+}

requirements.txt

@@ -1,3 +1,4 @@
 streamlit
+streamlit_cookies_controller
 datasets
 pandas

ui_components.py

@@ -6,7 +6,7 @@ def load_css():
     with open("assets/styles.css") as f:
         return f.read()
 
-def render_sidebar(moods, all_tags):
+def render_sidebar(cookie, locale, all_langs, moods, all_tags):
     """Рендеринг боковой панели с фильтрами"""
     with st.sidebar:
         st.markdown(
@@ -15,15 +15,30 @@ def render_sidebar(moods, all_tags):
             https://huggingface.co/datasets/loim/ru_fantasy_characters)
             """
         )
-        st.title("🔮 Фильтры")
-        search_query = st.text_input("🔍 Поиск по имени/описанию", "")
+
+        def on_language_change():
+            if st.session_state.lang_select != st.session_state.lang:
+                cookie.set("lang", st.session_state.lang_select)
+
+        st.selectbox(
+            locale["filter_lang"],
+            all_langs,
+            index=all_langs.index(st.session_state.lang),
+            on_change=on_language_change,
+            key="lang_select"
+        )
+
+        st.markdown("---")
+
+        st.title(locale["filter_title"])
+        search_query = st.text_input(locale["filter_search"], "")
         sort_option = st.selectbox(
-            "Сортировка",
-            ["По имени (А→Я)", "По имени (Я→А)", "По абсурдности (↑)", "По абсурдности (↓)"]
+            locale["filter_sort_title"],
+            locale["filter_sort"]
         )
-        absurdity_range = st.slider("Уровень абсурдности", 0, 10, (0, 10))
-        selected_mood = st.selectbox("Настроение", moods)
-        selected_tags = st.multiselect("Теги", all_tags)
+        absurdity_range = st.slider(locale["filter_absurd"], 0, 10, (0, 10))
+        selected_mood = st.selectbox(locale["filter_mood"], moods)
+        selected_tags = st.multiselect(locale["filter_tags"], all_tags)
     
     return {
         "search_query": search_query,
@@ -33,26 +48,51 @@ def render_sidebar(moods, all_tags):
         "selected_tags": selected_tags
     }
 
-def generate_rpg_card(row):
+@st.cache_data
+def generate_rpg_card(locale, row):
     """Генерация RPG-карточки персонажа"""
     return f"""
-**Мир:** {row['world']}
+**{locale["rpt_card_world"]}** {row['world']}
 
-**Имя:** {row['name']}
-**Внешность:** {row['description']}
-**Характер:** {row['short_story']}
-**Речь:** {row['style']}
+**{locale["rpt_card_name"]}** {row['name']}
+**{locale["rpt_card_desc"]}** {row['description']}
+**{locale["rpt_card_story"]}** {row['short_story']}
+**{locale["rpt_card_style"]}** {row['style']}
 
-**Первая реплика:** 
+**{locale["rpt_card_msg"]}** 
 > {row['first_message']}
 """
 
-def render_main_content(filtered_df):
+# Кэшированный рендеринг карточек
+@st.cache_data
+def render_character_card(locale, row):
+    with st.container():
+        st.markdown(f"### {row['name']}")
+        st.caption(f"*{row['short_story']}*")
+        
+        col1, col2 = st.columns([1, 3])
+        with col1:
+            st.markdown(f"**{locale["char_world"]}** {row['world']}")
+            st.markdown(f"**{locale["char_mood"]}** `{row['mood']}`")
+            st.markdown(f"**{locale["char_absurd"]}** `{row['absurdity']}/10`")
+            st.markdown(f"**{locale["char_tags"]}** `{' '.join(row['tags'].split())}`")
+        
+        with col2:
+            st.markdown(f"**{locale["char_desc"]}** {row['description']}")
+            st.markdown(f"**{locale["char_style"]}** *{row['style']}*")
+        
+        with st.expander(locale["char_rpg_card"], expanded=False):
+            rpg_card = generate_rpg_card(locale, row)
+            st.code(rpg_card, language="markdown")
+        
+        st.markdown("---")
+
+def render_main_content(locale, filtered_df):
     """Рендеринг основного контента с пагинацией"""
     st.title("🧙 Fantasy Characters Explorer")
     
     if len(filtered_df) == 0:
-        st.warning("Персонажи не найдены. Попробуйте изменить фильтры.")
+        st.warning(locale["main_not_found"])
     else:
         # Инициализация состояния пагинации
         if 'page' not in st.session_state:
@@ -66,7 +106,7 @@ def render_main_content(filtered_df):
         col1, col2, _ = st.columns([2, 3, 5])
         with col1:
             st.selectbox(
-                "Персонажей на странице",
+                locale["main_counter"],
                 options=[5, 10, 20],
                 index=1,
                 key='per_page',
@@ -74,7 +114,7 @@ def render_main_content(filtered_df):
             )
         with col2:
             st.number_input(
-                "Страница",
+                locale["main_page"],
                 min_value=0,
                 max_value=total_pages-1,
                 value=st.session_state.page,
@@ -88,151 +128,29 @@ def render_main_content(filtered_df):
         end_idx = min((st.session_state.page + 1) * st.session_state.per_page, len(filtered_df))
         
         # Отображение статистики
-        st.markdown(f"**Найдено персонажей:** {len(filtered_df)} (Страница {st.session_state.page + 1}/{total_pages})")
-        
-        # Кэшированный рендеринг карточек
-        @st.cache_data(max_entries=100)
-        def render_character_card(row):
-            with st.container():
-                st.markdown(f"### {row['name']}")
-                st.caption(f"*{row['short_story']}*")
-                
-                col1, col2 = st.columns([1, 3])
-                with col1:
-                    st.markdown(f"**🌍 Мир:** {row['world']}")
-                    st.markdown(f"**🎭 Настроение:** `{row['mood']}`")
-                    st.markdown(f"**🌀 Абсурдность:** `{row['absurdity']}/10`")
-                    st.markdown(f"**🏷️ Теги:** `{' '.join(row['tags'].split())}`")
-                
-                with col2:
-                    st.markdown(f"**📖 Описание:** {row['description']}")
-                    st.markdown(f"**💬 Стиль речи:** *{row['style']}*")
-                
-                with st.expander("📋 RPG-карточка", expanded=False):
-                    rpg_card = generate_rpg_card(row)
-                    st.code(rpg_card, language="markdown")
-                
-                st.markdown("---")
+        st.markdown(locale["main_found"].format(len(filtered_df), st.session_state.page, total_pages-1))
         
         # Рендеринг только видимых карточек
         for idx in range(start_idx, end_idx):
             row = filtered_df.iloc[idx]
-            render_character_card(row)
+            render_character_card(locale, row)
         
         # Кнопки навигации
         if total_pages > 1:
             cols = st.columns(4)
             with cols[0]:
-                if st.button("⏪ Первая страница", disabled=(st.session_state.page == 0)):
+                if st.button(locale["pages_first"], disabled=(st.session_state.page == 0)):
                     st.session_state.page = 0
                     st.rerun()
             with cols[1]:
-                if st.button("◀️ Назад", disabled=(st.session_state.page == 0)):
+                if st.button(locale["pages_before"], disabled=(st.session_state.page == 0)):
                     st.session_state.page -= 1
                     st.rerun()
             with cols[2]:
-                if st.button("Вперед ▶️", disabled=(st.session_state.page >= total_pages-1)):
+                if st.button(locale["pages_next"], disabled=(st.session_state.page >= total_pages-1)):
                     st.session_state.page += 1
                     st.rerun()
             with cols[3]:
-                if st.button("Последняя ⏩", disabled=(st.session_state.page == total_pages-1)):
+                if st.button(locale["pages_last"], disabled=(st.session_state.page == total_pages-1)):
                     st.session_state.page = total_pages-1
-                    st.rerun()
-
-def render_main_content(filtered_df):
-    """Рендеринг основного контента с пагинацией"""
-    st.title("🧙 Fantasy Characters Explorer")
-    
-    # Инициализация состояния пагинации
-    if 'page' not in st.session_state:
-        st.session_state.page = 0
-    
-    # Настройки пагинации
-    per_page = st.session_state.get('per_page', 10)
-    total_items = len(filtered_df)
-    total_pages = max(1, (total_items + per_page - 1) // per_page)
-    
-    # Корректировка номера страницы при изменении данных
-    if st.session_state.page >= total_pages:
-        st.session_state.page = max(0, total_pages - 1)
-    
-    # Управление пагинацией в колонках
-    col1, col2, _ = st.columns([2, 3, 5])
-    with col1:
-        st.selectbox(
-            "Персонажей на странице",
-            options=[5, 10, 20],
-            index=1,
-            key='per_page',
-            on_change=lambda: st.session_state.update(page=0)
-        )
-    with col2:
-        st.number_input(
-            "Страница",
-            min_value=0,
-            max_value=max(total_pages-1, 0),  # Защита от отрицательных значений
-            value=min(st.session_state.page, total_pages-1),  # Ограничение значения
-            key='page_input',
-            format="%d",
-            on_change=lambda: setattr(st.session_state, 'page', st.session_state.page_input)
-        )
-
-    # Рассчет диапазона записей
-    start_idx = st.session_state.page * per_page
-    end_idx = min(start_idx + per_page, total_items)
-    
-    # Отображение статистики
-    st.markdown(f"**Найдено персонажей:** {total_items} (Страница {st.session_state.page if total_items > 0 else 0}/{total_pages-1})")
-    
-    # Кэшированный рендеринг карточек
-    @st.cache_data
-    def render_character_card(row):
-        with st.container():
-            st.markdown(f"### {row['name']}")
-            st.caption(f"*{row['short_story']}*")
-            
-            col1, col2 = st.columns([1, 3])
-            with col1:
-                st.markdown(f"**🌍 Мир:** {row['world']}")
-                st.markdown(f"**🎭 Настроение:** `{row['mood']}`")
-                st.markdown(f"**🌀 Абсурдность:** `{row['absurdity']}/10`")
-                st.markdown(f"**🏷️ Теги:** `{' '.join(row['tags'].split())}`")
-            
-            with col2:
-                st.markdown(f"**📖 Описание:** {row['description']}")
-                st.markdown(f"**💬 Стиль речи:** *{row['style']}*")
-            
-            with st.expander("📋 RPG-карточка", expanded=False):
-                rpg_card = generate_rpg_card(row)
-                st.code(rpg_card, language="markdown")
-            
-            st.markdown("---")
-
-    # Рендеринг только видимых карточек
-    if total_items > 0:
-        for idx in range(start_idx, end_idx):
-            row = filtered_df.iloc[idx]
-            render_character_card(row)
-    else:
-        st.warning("Персонажи не найдены. Попробуйте изменить фильтры.")
-        return  # Прерываем выполнение чтобы избежать ошибок
-
-    # Кнопки навигации (только если есть результаты)
-    if total_pages > 1:
-        cols = st.columns(4)
-        with cols[0]:
-            if st.button("⏪ Первая страница", disabled=(st.session_state.page == 0)):
-                st.session_state.page = 0
-                st.rerun()
-        with cols[1]:
-            if st.button("◀️ Назад", disabled=(st.session_state.page == 0)):
-                st.session_state.page -= 1
-                st.rerun()
-        with cols[2]:
-            if st.button("Вперед ▶️", disabled=(st.session_state.page >= total_pages-1)):
-                st.session_state.page += 1
-                st.rerun()
-        with cols[3]:
-            if st.button("Последняя ⏩", disabled=(st.session_state.page == total_pages-1)):
-                st.session_state.page = total_pages-1
-                st.rerun()
+                    st.rerun()

utils.py

@@ -12,14 +12,14 @@ def get_search_mask(df, search_query):
     )
 
 @st.cache_data
-def apply_filters(df, search_query, absurdity_range, selected_mood, selected_tags, sort_option):
+def apply_filters(locale, df, search_query, absurdity_range, selected_mood, selected_tags, sort_option):
     """Применение фильтров и сортировки"""
     filtered_df = df[
         (df["absurdity"] >= absurdity_range[0]) & 
         (df["absurdity"] <= absurdity_range[1])
     ]
     
-    if selected_mood != "Все":
+    if selected_mood != locale["filter_all"]:
         filtered_df = filtered_df[filtered_df["mood"] == selected_mood]
     
     if selected_tags:
@@ -31,10 +31,10 @@ def apply_filters(df, search_query, absurdity_range, selected_mood, selected_tag
     
     # Сортировка
     sort_columns = {
-        "По имени (А→Я)": ("name", True),
-        "По имени (Я→А)": ("name", False),
-        "По абсурдности (↑)": ("absurdity", True),
-        "По абсурдности (↓)": ("absurdity", False)
+        locale["filter_sort"][0]: ("name", True),
+        locale["filter_sort"][1]: ("name", False),
+        locale["filter_sort"][2]: ("absurdity", True),
+        locale["filter_sort"][3]: ("absurdity", False)
     }
     col, asc = sort_columns[sort_option]
     return filtered_df.sort_values(col, ascending=asc)