An Interactive AI-Driven Career Exploration & Voice Assistant Platform
TalentX AI is an immersive platform that empowers users to explore career paths, simulate day-to-day experiences, interact with AI-powered agents, and manage personal portfolios. With voice-enabled AI, 3D avatars, and real-time multi-agent chat, TalentX AI provides a hands-on way to discover and shape your career journey.
- Avatar Selector: Choose from multiple 3D avatars to represent yourself.
- Voice Career Copilot: Converse with AI agents using text or voice input.
- Day-in-the-Life Simulation: Simulate real-world career scenarios.
- Spark Hub: Personalized space to explore tools, resources, and projects.
- Portfolio Management: Save conversation history, generated content, and HTML portfolios to AWS S3.
- Audio Interaction: Record and play back audio conversations with AI agents.
- Multi-Agent Chatbot: Master agent routes queries to sub-agents (Profile, Skill Mapping, Career Pathway, Portfolio).
| Layer | Technology / Libraries |
|---|---|
| Frontend | Streamlit, HTML/CSS, 3D Model Viewer |
| Backend | Python, AWS Bedrock, Amazon Polly, Amazon Transcribe, DynamoDB, S3 |
| Voice Processing | Streamlit Mic Recorder, PyDub, Wave |
| Data & Utils | Pandas, NumPy, SciPy, BeautifulSoup4, Requests |
Follow these steps to run TalentX AI locally:
git clone https://github.com/yourusername/talentx-ai.git
cd talentx-aipip install -r requirements.txtTalentX AI requires the following AWS services to run properly:
-
S3 Bucket
- Store user portfolios, audio recordings, and generated content.
- Ensure the bucket name matches the one used in the code.
-
DynamoDB Table
- Store chat history, session data, and agent state.
- Make sure the table schema matches your code configuration.
-
AWS Bedrock Agents (Multi-Agent Chatbot)
- Create the Master Agent.
- This agent routes user queries to the correct sub-agent and aggregates responses.
- Replace the placeholder
MASTER_AGENT_IDin your code with the actual Master Agent ID.
- Create the Sub-Agents:
- Profile Agent – handles user profile and personal info.
- Skill Mapping Agent – evaluates skills and suggests potential roles.
- Career Pathway Agent – recommends career paths and milestones.
- Portfolio Agent – manages portfolio content and S3 storage.
- Replace the respective IDs in the code for each sub-agent (
PROFILE_AGENT_ID,SKILL_AGENT_ID, etc.) with your actual agent IDs.
- Configure each agent with instructions/prompts for its role.
- Example prompts are provided in the Multi-Agent Instructions table.
- You can further refine and expand prompts to improve agent behavior.
- Create the Master Agent.
⚠️ You must create your own AWS resources; pre-built agents cannot be shared.
| Agent Type | Agent Name | Purpose / Role Description | Example Instructions / Prompts |
|---|---|---|---|
| Master Agent | Master Agent | Routes user queries to appropriate sub-agents and compiles final responses. | - Receive user input (text/voice). - Decide which sub-agent(s) to query. - Aggregate and return responses. - Example prompt: "Route this user input to the correct sub-agent and combine responses in friendly language." |
| Sub-Agent | Profile Agent | Handles user profile, personal info, and identity-related queries. | - Analyze user's profile details. - Suggest career archetypes. - Update profile state in DynamoDB. - Example prompt: "Assess the user's profile and suggest a career archetype with reasoning." |
| Sub-Agent | Skill Mapping Agent | Maps user's skills, strengths, and interests to potential roles and career paths. | - Evaluate user's skills. - Suggest skill improvements or roles. - Return structured data to Master Agent. - Example prompt: "Map user's skills to potential career paths and suggest improvements." |
| Sub-Agent | Career Pathway Agent | Suggests possible career paths, timelines, and learning steps based on user input. | - Recommend career pathways based on profile/skills. - Provide suggested milestones. - Example prompt: "Create a detailed career roadmap with milestones based on user's profile and skills." |
| Sub-Agent | Portfolio Agent | Manages portfolio-related queries, generates content, and stores assets in S3. | - Save user-generated content, conversation logs, and portfolio files. - Provide links or summaries of portfolio assets. - Example prompt: "Store and summarize user portfolio content in S3, returning accessible links." |
⚠️ Note: These instructions are example prompts. You can further refine and expand the prompts for each agent based on your specific use case. Each agent must be created separately in AWS Bedrock, and the Master Agent routes queries but does not contain the sub-agent logic itself.
⚠️ You must create your own AWS resources; the pre-built agents cannot be shared.
streamlit run app.pyOpen the URL in your terminal (usually http://localhost:8501) to access the platform.
Here’s what the TalentX AI app looks like when running locally:
