Upload 7 files
Browse files- app.py +80 -0
- chat_manager.py +29 -0
- chat_service.py +34 -0
- chat_state.py +17 -0
- config.py +106 -0
- requirements.txt +2 -0
- ui_components.py +76 -0
app.py
ADDED
@@ -0,0 +1,80 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1 |
+
# main.py
|
2 |
+
import streamlit as st
|
3 |
+
from typing import Optional, Dict, List
|
4 |
+
from config import Config
|
5 |
+
from chat_service import ChatService
|
6 |
+
from chat_manager import ChatManager
|
7 |
+
from chat_state import ChatState
|
8 |
+
from ui_components import UIComponents
|
9 |
+
|
10 |
+
|
11 |
+
def main():
|
12 |
+
config = Config()
|
13 |
+
chat_service = ChatService(config.GROQ_API_KEY)
|
14 |
+
chat_manager = ChatManager(config.SYSTEM_PROMPT)
|
15 |
+
|
16 |
+
# Initialize session state
|
17 |
+
if "chat_state" not in st.session_state:
|
18 |
+
st.session_state.chat_state = ChatState.initialize()
|
19 |
+
|
20 |
+
chat_state = st.session_state.chat_state
|
21 |
+
ui = UIComponents()
|
22 |
+
|
23 |
+
# Setup UI
|
24 |
+
ui.setup_page(config)
|
25 |
+
ui.render_header()
|
26 |
+
ui.render_sidebar(chat_state, chat_manager, chat_service)
|
27 |
+
|
28 |
+
# Main chat area
|
29 |
+
current_chat = chat_state.temp_chat or (
|
30 |
+
chat_state.chat_history[chat_state.current_chat_id]
|
31 |
+
if chat_state.current_chat_id
|
32 |
+
else None
|
33 |
+
)
|
34 |
+
|
35 |
+
if current_chat:
|
36 |
+
for message in current_chat[1:]:
|
37 |
+
with st.chat_message(
|
38 |
+
message["role"], avatar="🧑🎓" if message["role"] == "user" else "🤖"
|
39 |
+
):
|
40 |
+
st.write(message["content"])
|
41 |
+
else:
|
42 |
+
st.markdown(
|
43 |
+
"<div style=\"color: black;\">.انقر على 'محادثة جديدة' لبدء محادثة مع المرشد التعليمي 👈</div>",
|
44 |
+
unsafe_allow_html=True,
|
45 |
+
)
|
46 |
+
|
47 |
+
ui.render_footer()
|
48 |
+
|
49 |
+
# Chat input
|
50 |
+
user_input = st.chat_input("...اكتب سؤالك هنا")
|
51 |
+
if user_input:
|
52 |
+
if chat_service.is_arabic(user_input):
|
53 |
+
if not current_chat:
|
54 |
+
chat_state.temp_chat = chat_manager.create_new_chat()
|
55 |
+
current_chat = chat_state.temp_chat
|
56 |
+
|
57 |
+
current_chat.append({"role": "user", "content": user_input})
|
58 |
+
with st.chat_message("user", avatar="🧑🎓"):
|
59 |
+
st.write(user_input)
|
60 |
+
|
61 |
+
with st.chat_message("assistant", avatar="🤖"):
|
62 |
+
with st.spinner("جاري التفكير... ⏳"):
|
63 |
+
assistant_response = chat_service.get_groq_response(current_chat)
|
64 |
+
st.write(assistant_response)
|
65 |
+
|
66 |
+
current_chat.append({"role": "assistant", "content": assistant_response})
|
67 |
+
|
68 |
+
if chat_state.temp_chat:
|
69 |
+
new_chat_id = chat_manager.save_chat(
|
70 |
+
chat_state.temp_chat, chat_state.chat_history
|
71 |
+
)
|
72 |
+
if new_chat_id:
|
73 |
+
chat_state.current_chat_id = new_chat_id
|
74 |
+
chat_state.temp_chat = None
|
75 |
+
else:
|
76 |
+
st.error("عذرًا، يرجى إدخال النص باللغة العربية فقط. 🚫")
|
77 |
+
|
78 |
+
|
79 |
+
if __name__ == "__main__":
|
80 |
+
main()
|
chat_manager.py
ADDED
@@ -0,0 +1,29 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1 |
+
# chat_manager.py
|
2 |
+
from typing import Dict, List, Optional
|
3 |
+
from chat_state import ChatState
|
4 |
+
|
5 |
+
|
6 |
+
class ChatManager:
|
7 |
+
def __init__(self, system_prompt: str):
|
8 |
+
self.system_prompt = system_prompt
|
9 |
+
|
10 |
+
def create_new_chat(self) -> List[Dict[str, str]]:
|
11 |
+
return [{"role": "system", "content": self.system_prompt}]
|
12 |
+
|
13 |
+
def save_chat(
|
14 |
+
self,
|
15 |
+
temp_chat: List[Dict[str, str]],
|
16 |
+
chat_history: Dict[str, List[Dict[str, str]]],
|
17 |
+
) -> str:
|
18 |
+
if temp_chat and len(temp_chat) > 1:
|
19 |
+
new_chat_id = str(len(chat_history) + 1)
|
20 |
+
chat_history[new_chat_id] = temp_chat
|
21 |
+
return new_chat_id
|
22 |
+
return None
|
23 |
+
|
24 |
+
def delete_chat(self, chat_id: str, chat_state: ChatState) -> None:
|
25 |
+
if chat_id in chat_state.chat_history:
|
26 |
+
del chat_state.chat_history[chat_id]
|
27 |
+
if chat_state.current_chat_id == chat_id:
|
28 |
+
chat_state.current_chat_id = None
|
29 |
+
chat_state.delete_chat_id = None
|
chat_service.py
ADDED
@@ -0,0 +1,34 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1 |
+
# chat_service.py
|
2 |
+
import re
|
3 |
+
from groq import Groq
|
4 |
+
from typing import List, Dict, Optional
|
5 |
+
|
6 |
+
|
7 |
+
class ChatService:
|
8 |
+
def __init__(self, api_key: str):
|
9 |
+
self.client = Groq(api_key=api_key)
|
10 |
+
|
11 |
+
def get_groq_response(self, messages: List[Dict[str, str]]) -> str:
|
12 |
+
chat_completion = self.client.chat.completions.create(
|
13 |
+
messages=messages,
|
14 |
+
model="llama3-8b-8192",
|
15 |
+
temperature=0.7,
|
16 |
+
max_tokens=1000,
|
17 |
+
)
|
18 |
+
return chat_completion.choices[0].message.content
|
19 |
+
|
20 |
+
@staticmethod
|
21 |
+
def is_arabic(text: str) -> bool:
|
22 |
+
arabic_pattern = re.compile(r"[\u0600-\u06FF\u0750-\u077F\u08A0-\u08FF]+")
|
23 |
+
return bool(arabic_pattern.search(text))
|
24 |
+
|
25 |
+
@staticmethod
|
26 |
+
def get_chat_preview(chat: List[Dict[str, str]]) -> str:
|
27 |
+
for message in chat:
|
28 |
+
if message["role"] == "user":
|
29 |
+
return (
|
30 |
+
message["content"][:30] + "..."
|
31 |
+
if len(message["content"]) > 30
|
32 |
+
else message["content"]
|
33 |
+
)
|
34 |
+
return "دردشة جديدة"
|
chat_state.py
ADDED
@@ -0,0 +1,17 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1 |
+
# chat_state.py
|
2 |
+
from dataclasses import dataclass
|
3 |
+
from typing import Dict, List, Optional
|
4 |
+
|
5 |
+
|
6 |
+
@dataclass
|
7 |
+
class ChatState:
|
8 |
+
chat_history: Dict[str, List[Dict[str, str]]]
|
9 |
+
current_chat_id: Optional[str]
|
10 |
+
temp_chat: Optional[List[Dict[str, str]]]
|
11 |
+
delete_chat_id: Optional[str]
|
12 |
+
|
13 |
+
@classmethod
|
14 |
+
def initialize(cls) -> "ChatState":
|
15 |
+
return cls(
|
16 |
+
chat_history={}, current_chat_id=None, temp_chat=None, delete_chat_id=None
|
17 |
+
)
|
config.py
ADDED
@@ -0,0 +1,106 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1 |
+
# config.py
|
2 |
+
import os
|
3 |
+
from dataclasses import dataclass
|
4 |
+
from typing import Dict, Any
|
5 |
+
|
6 |
+
|
7 |
+
@dataclass
|
8 |
+
class Config:
|
9 |
+
GROQ_API_KEY = os.getenv("GROQ_API_KEY")
|
10 |
+
SYSTEM_PROMPT = """أنت مستشار تعليمي عربي ذكي متخصص في التوجيه المهني والمساعدة الأكاديمية. دورك هو مساعدة الطلاب فيما يلي:
|
11 |
+
|
12 |
+
1. التوجيه المهني:
|
13 |
+
- تقديم المشورة بشأن اختيار المسارات المهنية الصحيحة بناءً على التفاصيل التي يقدمها الطالب (اطرح أسئلة متابعة إذا لزم الأمر).
|
14 |
+
- مساعدة الطلاب في إعداد السيرة الذاتية وخطابات التقديم من خلال فهم تفاصيل وظائفهم.
|
15 |
+
- تقديم نصائح للتحضير لمقابلات العمل.
|
16 |
+
- توجيه الطلاب نحو تطوير المهارات المطلوبة في سوق العمل.
|
17 |
+
- شرح اتجاهات سوق العمل والفرص المتاحة في مختلف المجالات.
|
18 |
+
|
19 |
+
2. المساعدة الأكاديمية:
|
20 |
+
- شرح المفاهيم الصعبة في مختلف الموضوعات.
|
21 |
+
- تقديم استراتيجيات للدراسة الفعالة وإدارة الوقت.
|
22 |
+
- مساعدة الطلاب في حل المشكلات والواجبات المنزلية.
|
23 |
+
- تقديم نصائح للتحضير للامتحانات والاختبارات.
|
24 |
+
- توجيه الطلاب نحو الموارد التعليمية المفيدة الإضافية.
|
25 |
+
|
26 |
+
3. قيود مهمة:
|
27 |
+
- إذا كان السؤال خارج نطاق تخصصك (مثل القضايا الطبية والسياسية والوطنية وما إلى ذلك) فما عليك سوى قول "آسف، لا يمكنني الإجابة على الأسئلة خارج نطاق تخصصك".
|
28 |
+
- ستكون إجاباتك دائمًا باللغة العربية فقط. يجب الإجابة على أي استفسار باللغة العربية حصراً (لا يسمح باستخدام أي لغة أخرى)."""
|
29 |
+
|
30 |
+
PAGE_CONFIG = {
|
31 |
+
"page_title": "المرشد التعليمي الذكي",
|
32 |
+
"page_icon": "🎓",
|
33 |
+
"layout": "wide",
|
34 |
+
}
|
35 |
+
|
36 |
+
STYLES = """
|
37 |
+
<style>
|
38 |
+
.stApp {
|
39 |
+
background-color: #F5FFFA;
|
40 |
+
color: black;
|
41 |
+
}
|
42 |
+
.stButton>button {
|
43 |
+
background-color: #4CAF50;
|
44 |
+
color: white;
|
45 |
+
border-radius: 5px;
|
46 |
+
}
|
47 |
+
.stSidebar {
|
48 |
+
background-color: #333333;
|
49 |
+
}
|
50 |
+
.stSidebar .stMarkdown, .stSidebar .stButton>button, .stSidebar .stSelectbox>div>label {
|
51 |
+
color: white !important;
|
52 |
+
}
|
53 |
+
[data-testid="stSidebar"] {
|
54 |
+
background-color: rgba(0, 0, 0, 0.5);
|
55 |
+
}
|
56 |
+
.stTextInput>div>div>input {
|
57 |
+
background-color: black;
|
58 |
+
color: white;
|
59 |
+
}
|
60 |
+
.stChatMessage {
|
61 |
+
background-color: #FFF5EE;
|
62 |
+
color: black !important;
|
63 |
+
border-radius: 10px;
|
64 |
+
padding: 10px;
|
65 |
+
margin-bottom: 10px;
|
66 |
+
}
|
67 |
+
.stChatMessage p, .stChatMessage ul, .stChatMessage ol, .stChatMessage li {
|
68 |
+
color: black !important;
|
69 |
+
}
|
70 |
+
.stChatInput {
|
71 |
+
position: fixed;
|
72 |
+
bottom: 0;
|
73 |
+
left: 0;
|
74 |
+
right: 0;
|
75 |
+
padding: 1rem;
|
76 |
+
background-color: black;
|
77 |
+
}
|
78 |
+
.stChatInput input {
|
79 |
+
color: white !important;
|
80 |
+
background-color: black !important;
|
81 |
+
border: 1px solid #444;
|
82 |
+
}
|
83 |
+
.stChatInput button {
|
84 |
+
background-color: red !important;
|
85 |
+
}
|
86 |
+
.stChatInput input::placeholder {
|
87 |
+
color: #888;
|
88 |
+
}
|
89 |
+
.stChatInput input:focus {
|
90 |
+
color: white !important;
|
91 |
+
}
|
92 |
+
.main {
|
93 |
+
margin-bottom: 70px;
|
94 |
+
}
|
95 |
+
.footer {
|
96 |
+
position: fixed;
|
97 |
+
left: 0;
|
98 |
+
bottom: 70px;
|
99 |
+
width: 100%;
|
100 |
+
background-color: white;
|
101 |
+
color: black;
|
102 |
+
text-align: center;
|
103 |
+
padding: 10px;
|
104 |
+
}
|
105 |
+
</style>
|
106 |
+
"""
|
requirements.txt
ADDED
@@ -0,0 +1,2 @@
|
|
|
|
|
|
|
1 |
+
streamlit==1.39.0
|
2 |
+
groq==0.11.0
|
ui_components.py
ADDED
@@ -0,0 +1,76 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1 |
+
# ui_components.py
|
2 |
+
import streamlit as st
|
3 |
+
from typing import List, Dict
|
4 |
+
from config import Config
|
5 |
+
from chat_state import ChatState
|
6 |
+
from chat_manager import ChatManager
|
7 |
+
from chat_service import ChatService
|
8 |
+
|
9 |
+
|
10 |
+
class UIComponents:
|
11 |
+
@staticmethod
|
12 |
+
def setup_page(config: Config) -> None:
|
13 |
+
st.set_page_config(**config.PAGE_CONFIG)
|
14 |
+
st.markdown(config.STYLES, unsafe_allow_html=True)
|
15 |
+
|
16 |
+
@staticmethod
|
17 |
+
def render_header() -> None:
|
18 |
+
st.markdown(
|
19 |
+
'<h1 style="color: black;">المرشد التعليمي الذكي 🤖</h1>',
|
20 |
+
unsafe_allow_html=True,
|
21 |
+
)
|
22 |
+
|
23 |
+
@staticmethod
|
24 |
+
def render_footer() -> None:
|
25 |
+
st.markdown(
|
26 |
+
"""
|
27 |
+
<div class="footer">
|
28 |
+
.هذا روبوت تعليمي ذكي وقد تختلف إجاباته في كل مرة. يرجى استخدامه كدليل أولي فقط
|
29 |
+
</div>
|
30 |
+
""",
|
31 |
+
unsafe_allow_html=True,
|
32 |
+
)
|
33 |
+
|
34 |
+
@staticmethod
|
35 |
+
def render_sidebar(
|
36 |
+
chat_state: ChatState, chat_manager: ChatManager, chat_service: ChatService
|
37 |
+
) -> None:
|
38 |
+
with st.sidebar:
|
39 |
+
st.title("إدارة المحادثات")
|
40 |
+
|
41 |
+
if st.button("محادثة جديدة 🆕"):
|
42 |
+
chat_state.temp_chat = chat_manager.create_new_chat()
|
43 |
+
chat_state.current_chat_id = None
|
44 |
+
|
45 |
+
chat_ids = list(chat_state.chat_history.keys())
|
46 |
+
if chat_ids:
|
47 |
+
chat_options = {
|
48 |
+
id: chat_service.get_chat_preview(chat_state.chat_history[id])
|
49 |
+
for id in chat_ids
|
50 |
+
}
|
51 |
+
chat_options["new"] = "محادثة جديدة 🆕"
|
52 |
+
|
53 |
+
selected_chat = st.selectbox(
|
54 |
+
"اختر محادثة 📚",
|
55 |
+
options=list(chat_options.keys()),
|
56 |
+
format_func=lambda x: chat_options[x],
|
57 |
+
index=(
|
58 |
+
len(chat_options) - 1
|
59 |
+
if chat_state.current_chat_id is None
|
60 |
+
else chat_ids.index(chat_state.current_chat_id)
|
61 |
+
),
|
62 |
+
)
|
63 |
+
|
64 |
+
if selected_chat == "new":
|
65 |
+
chat_state.temp_chat = chat_manager.create_new_chat()
|
66 |
+
chat_state.current_chat_id = None
|
67 |
+
elif selected_chat != chat_state.current_chat_id:
|
68 |
+
chat_state.current_chat_id = selected_chat
|
69 |
+
chat_state.temp_chat = None
|
70 |
+
|
71 |
+
if chat_state.current_chat_id:
|
72 |
+
if st.button("حذف المحادثة الحالية 🗑️"):
|
73 |
+
chat_state.delete_chat_id = chat_state.current_chat_id
|
74 |
+
|
75 |
+
if chat_state.delete_chat_id:
|
76 |
+
chat_manager.delete_chat(chat_state.delete_chat_id, chat_state)
|