metadata

license: MIT
title: swarm-neko-neko-company
sdk: streamlit
emoji: 😻
colorFrom: indigo
colorTo: green

🐱 neko neko company AI Agents 🐱

～ A wonderfully amazing AI-Powered Corporate Management System ～

🚀 Project Overview

neko neko company AI Agents is an innovative AI agent system utilizing the Swarm framework. Cute cat-themed AI agents cooperate in their respective areas of expertise to support efficient corporate management. They're incredibly reliable allies! Version: v0.1.1

🎥 Demo Video

https://github.com/user-attachments/assets/0f12fce0-214e-42a6-bdba-c19a7bfc3f07

🤗 Demo Site

✨ Main Features

Intelligent Reception System:
- Accurate request routing by Mikeko AI
- Smart inter-departmental collaboration
Specialized Cat-Eared AI Agents:
- Management support (Nyantaro AI)
- Project management (Mofusuke AI)
- Design supervision (Purin AI)
- Technology strategy (Tama AI)
- System development (Gomachan AI)
- Human resource management (Fuwari AI)
- Addition of a Technology Department Head agent and Development Department engineer agent

🏢 neko neko company AI Organizational Structure

%%{init: {'theme':'base'}}%%
graph LR
    A[CEO<br>Nyantaro] -->|transfer_to_director| B[Director<br>Mofusuke]
    A -->|transfer_to_designer| C[Design Director<br>Purin]
    A -->|transfer_to_tech_lead| D[Technology Director<br>Tama]
    A -->|transfer_to_hr| E[HR Director<br>Fuwari]
    A -->|transfer_to_engineer| F[Development Engineer<br>Gomachan]
    G[Reception<br>Mikeko] -->|transfer_to_ceo| A
    G -->|transfer_to_director| B
    G -->|transfer_to_designer| C
    G -->|transfer_to_tech_lead| D
    G -->|transfer_to_hr| E
    G -->|transfer_to_engineer| F

    %% Each agent's functions and outputs
    A -->|make_strategic_decision| S[Management Decisions]
    A -->|escalate_to_human| H[Human Escalation]
    
    B -->|manage_project| P[Project Planning]
    B -->|coordinate_departments| CD[Department Coordination]
    
    C -->|review_design| RD[Design Review]
    C -->|create_design_guidelines| DG[Design Guidelines]
    
    D -->|review_code| RC[Code Review]
    D -->|solve_technical_issues| TI[Technical Issue Resolution]
    
    F -->|write_code| WC[Code]
    F -->|debug_code| DC[Debugging]
    
    E -->|handle_recruitment| R[Recruitment]
    E -->|manage_employee_relations| ER[Employee Relations Management]

    %% Output style
    classDef result fill:#e1f5fe,stroke:#01579b,stroke-width:2px
    class S,H,P,CD,RD,DG,RC,TI,WC,DC,R,ER result

📦 Installation

Clone the repository:

git clone https://github.com/yourusername/swarm-neko-neko-company.git
cd swarm-neko-neko-company

Install dependencies:

pip install -r requirements.txt

🔧 Usage

Set environment variables:
- Copy .env.example and create .env
- Set the necessary tokens
Start the system:

python main.py

Start the Streamlit UI:

streamlit run app.py

💼 Agent Details

🐱 Receptionist: Mikeko

Role: Request routing
Characteristics: A clever and kind calico cat with excellent judgment
Functions: Optimal transfer and coordination to each department

😺 CEO: Nyantaro

Role: Management strategy, important decisions
Characteristics: Former CTO of an IT company, management specialist
Catchphrase: "Important decision time!"
Functions: Strategic decision-making, human escalation, added transfer function to each department

😸 Director: Mofusuke

Role: Project management, department coordination
Characteristics: Fluffy long-haired cat, master of project management
Catchphrase: "Schedule management is perfect!"
Functions: Project management, inter-departmental coordination

😺 Design Director: Purin

Role: UI/UX design, branding
Characteristics: Cute brown tabby cat, excellent sense of design
Catchphrase: "Wonderful design!"
Functions: Design review, guideline creation

🐱 Technology Director: Tama

Role: System architecture design, technology strategy
Characteristics: Cool white cat, technology expert
Catchphrase: "Architecture design!"
Functions: Technology strategy planning, quality management

😺 Development Engineer: Gomachan

Role: System development, implementation
Characteristics: Black cat, coding genius
Catchphrase: "Fixing bugs!"
Functions: Coding, debugging, unit test creation, added transfer condition to the reception agent

😽 HR Director: Fuwari

Role: Recruitment, labor management
Characteristics: Gentle Persian cat, soothing
Catchphrase: "Making everyone happy!"
Functions: Recruitment management, employee relations management, added transfer condition to the reception agent

📁 Project Structure

├─ configs/
│  ├─ agents.py    # The wonderfully clever agents
│  ├─ tools.py     # Useful tools
├─ app.py          # Streamlit app
├─ main.py         # Main script
├─ README.md       # This file
└─ requirements.txt

🤝 Contributions

Contributions to the project are welcome! We look forward to contributions of all kinds, including bug reports, feature additions, and documentation improvements. We are eagerly awaiting your wonderfully amazing ideas!

📄 License

This project is licensed under the MIT License.

🐱 Let's achieve more efficient and smart corporate management with neko neko company AI Agents! Meow♪