🚀 Microblog AI with Next.js & AI Technologies

Complete Workshop: Learn how to build an intelligent microblog with Next.js and AI technologies, from scratch to ready to production applicatoin!

This repository contains the code and materials for a hands-on workshop about building a microblog application with Next.js, integrating advanced AI features and exploring modern architectures. The goal is to provide a practical journey from initial to ready to production application, using best practices and current tools.

🚀 Try Instantly with GitHub Codespaces

Want to test or explore the application quickly? Click the button below to open this project directly in a GitHub Codespace — no setup required!

🎯 About the Workshop

• From scratch to ready to production: Learn how to set up, develop and let ready to deploy.
• Modern technologies: Next.js, Tailwind CSS, TypeScript, Azure, OpenAI, LangChain.js, and more.
• Evolving roadmap: The project is constantly evolving with new versions that expand features and AI integrations.

This workshop is available in multiple languages:

• 🇧🇷 Portuguese: @glaucia86/microblog-ai-nextjs/files/workshop/pt-br/v1/00-initial.md
• 🇺🇸 English: @glaucia86/microblog-ai-nextjs/files/workshop/en-us/v1/00-initial.md

🖥️ How to Run Locally

You can run the application locally using GitHub Models. Follow these steps:

1. 📦 Install dependencies:

   npm install
   

2. 🏗️ Build the application:

   npm run build
   

3. ⚙️ Create a .env file at the root of the project:

   NEXT_PUBLIC_GITHUB_MODELS_TOKEN=
   NEXT_PUBLIC_GITHUB_MODELS_ENDPOINT=
   

   Fill in the values with your own GitHub Models environment credentials.

4. ▶️ Start the application:

   npm run start
   

✨ See the application running:

🗺️ Roadmap: Next Steps

The project evolves through versions, each bringing new advancements:

🔹 v2 – LangChain.js

• 📌 Implementation of LangChain.js – the leading web framework for AI, providing advanced tools for building intelligent applications.

🔹 v3 – RAG Architecture (Retrieval-Augmented Generation)

• 🧩 Implementation of the RAG architecture (Retrieval-Augmented Generation), making it possible to combine database search with AI-generated responses, allowing the model to access external information and respond in a contextualized and up-to-date manner.
• 🔍 Contextual queries and optimized responses make the microblog smarter, capable of answering based on real and dynamic content.

🔹 v4 – Integration with Intelligent Agents

• 🕹️ Integration of intelligent agents that automate tasks, perform advanced interactions, and can act autonomously within the application, using the context provided by the RAG architecture.
• 🤖 Agents will further enhance the user experience, making the microblog interactive and adaptive to different needs.

🔹 v5 – Model Context Protocol (MCP) with Agents

• 🧠 MCP protocol to manage context and interaction between agents and AI models, ensuring efficient communication and advanced contextualization.

🔹 v6 – Deploy with Terraform, Cloud Provider (GCP, AWS, Vercel or Azure)/Toolhouse and LLM Providers (OpenAI, Ollama, Gemini...)

• 🚢 Automate deployment with Terraform and IaC (Infrastructure as Code).
• ☁️ Orchestrate containers with a Cloud Provider (GCP, AWS, Vercel, or Azure) and Toolhouse for AI agents.
• 🤖 Integrate additional intelligent features to expand the possibilities of the microblog.

💡 Why Give a Star and Fork?

If you enjoyed the project or want to follow its evolution:

• ⭐ Star the repo to support and get notified of new updates!
• 🍴 Fork the repo to test, modify, or learn from the code.
• 💬 Share with anyone interested in learning about applied AI in web!

🤝 How to Contribute

1. 🍴 Fork the repository
2. 🌱 Create a new branch: git checkout -b my-feature
3. ✏️ Commit: git commit -m 'feat: my new feature'
4. 🚀 Push: git push origin my-feature
5. 🔄 Open a Pull Request

📬 Contact

Open issues for questions, suggestions, or bug reports!

✨ Follow the roadmap and contribute to the evolution of this project! 🚀