Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation


⚡ S2AI — Dual-AI Interaction Playground

S2AI is an open-source experimental project that allows two AI models to interact, reason, and respond together, powered by a React frontend and a Node.js + Express backend.

This project was built to move beyond tutorials and into real system design, provider orchestration, and frontend–backend integration.


🎯 Why This Project Exists

  • Build something from scratch
  • Learn how AI systems are wired together
  • Experiment with multiple AI providers
  • Understand real-world backend architecture
  • Create a usable, open-source learning project

This is not a SaaS, not a product, and not monetized. It’s a learning playground. The Full project is currently under Construction and don't know when realissed


🧠 Core Idea

  • AI-1 generates a response
  • AI-2 reviews / critiques / adjusts internally
  • Only the final, public-safe output is returned to the user
  • Provider logic is modular and extensible

🛠️ Tech Stack

Frontend

  • React (Vite)
  • TypeScript
  • React Router
  • Tailwind CSS
  • Context API (in-memory state)

Backend

  • Node.js
  • Express.js
  • Modular services & controllers
  • Provider-based architecture

AI Providers

  • OpenAI
  • Gemini
  • Ollama (local models like LLaMA 3)
  • Easy to extend with new providers

📁 Project Structure (Simplified)

/frontend
 └─ src
    ├─ app
    ├─ components
    ├─ pages
    ├─ context
    ├─ services
    └─ utils

/backend
 └─ src
    ├─ routes
    ├─ controllers
    ├─ services
    ├─ providers
    └─ app.js

🚀 Getting Started

1️⃣ Clone the repository

git clone https://github.com/your-username/S2AI.git
cd S2AI

2️⃣ Start the Backend

cd backend
npm install
npm run dev

Runs at:

http://localhost:5000

3️⃣ Start the Frontend

cd frontend
npm install
npm run dev

Runs at:

http://localhost:5173

4️⃣ Add Your API Key

You must provide your own API key from one of the supported providers:

  • OpenAI
  • Gemini
  • Ollama (local)

Paste the key into the Settings section inside the app.

🔐 API keys are:

  • validated by the backend
  • kept in memory only
  • never stored or logged

⚠️ Important Notes

  • Experimental project
  • Prompts and logic are still being refined
  • No authentication (by design)
  • Not production-ready
  • Focused on learning, not scale

🧪 What You’ll Learn From This

  • Provider-based system design
  • Frontend vs backend responsibility
  • API validation strategies
  • Real debugging (not tutorial land)
  • Why building beats watching

🤝 Contributing

Feel free to:

  • Fork the repo
  • Improve prompts
  • Add providers
  • Refactor architecture
  • Experiment freely

PRs and ideas are welcome.


📜 License

Open-source. Use it. Break it. Learn from it.


🧠 Final Thought

At some point the question changed from “What tutorial should I watch next?” to “When am I going to build my own thing?”

This is that thing.

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages