Skip to content

Commit c4866d0

Browse files
TellMeAlexTellMeAlex
committed
Merge branch 'main' of github.com:CodigoSinSiesta/codigosinsiesta.github.io into auto-claude/006-companion-code-repository
2 parents 9b6927e + e633d48 commit c4866d0

File tree

16 files changed

+2408
-0
lines changed

16 files changed

+2408
-0
lines changed

‎.auto-claude/worktrees/tasks/codigosinsiesta-examples/README.md‎

Lines changed: 145 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,145 @@
1+
# Código Sin Siesta - Examples Repository
2+
3+
Welcome to the companion code repository for [Código Sin Siesta](https://codigosinsiesta.com)! 🚀
4+
5+
This repository contains all the working code examples from our documentation and blog posts. Each example is organized by topic with complete setup instructions, dependencies, and runnable code.
6+
7+
## 📑 Table of Contents
8+
9+
- [What's Inside](#-whats-inside)
10+
- [AI Agents & MCP Workshop](#-ai-agents--mcp-workshop)
11+
- [AI Architecture](#️-ai-architecture)
12+
- [Tools & Utilities](#-tools--utilities)
13+
- [Getting Started](#-getting-started)
14+
- [Documentation](#-documentation)
15+
- [Prerequisites](#-prerequisites)
16+
- [Contributing](#-contributing)
17+
- [License](#-license)
18+
- [Links](#-links)
19+
20+
## 📚 What's Inside
21+
22+
All examples are organized by topic to match the documentation structure:
23+
24+
### 🤖 AI Agents & MCP Workshop
25+
26+
Complete examples from our AI Agents and Model Context Protocol workshop:
27+
28+
- **[01-agente-tareas](./taller-ia-agentes-mcp/01-agente-tareas/)** - Task management agent with memory
29+
- **[02-agente-investigador](./taller-ia-agentes-mcp/02-agente-investigador/)** - Research agent with web search
30+
- **[03-mcp-servers](./taller-ia-agentes-mcp/03-mcp-servers/)** - Model Context Protocol server implementation
31+
32+
📖 **[View Workshop Guide →](https://codigosinsiesta.com/docs/proyectos/taller-ia-agentes-mcp/)**
33+
34+
### 🏗️ AI Architecture
35+
36+
Examples demonstrating AI system architecture patterns and best practices for production systems.
37+
38+
**[Browse AI Architecture Examples →](./arquitectura-ia/)**
39+
40+
Topics covered:
41+
- Agent orchestration patterns
42+
- Prompt management and versioning
43+
- Error handling and retry strategies
44+
- Cost optimization techniques
45+
- Performance monitoring
46+
47+
### 🔧 Tools & Utilities
48+
49+
Practical tool implementations, utilities, and helper libraries for AI development.
50+
51+
**[Explore Tools & Utilities →](./herramientas/)**
52+
53+
Includes:
54+
- CLI tools for AI workflows
55+
- Reusable helper libraries
56+
- Integration scripts
57+
- Development utilities
58+
59+
## 🚀 Getting Started
60+
61+
Each example directory contains:
62+
63+
- **README.md** - Setup instructions and explanation
64+
- **package.json** - Dependencies and scripts
65+
- **.env.example** - Required environment variables
66+
- **Complete source code** - Ready to run
67+
68+
### Quick Start
69+
70+
1. Clone this repository:
71+
```bash
72+
git clone https://github.com/codigosinsiesta/codigosinsiesta-examples.git
73+
cd codigosinsiesta-examples
74+
```
75+
76+
2. Navigate to an example:
77+
```bash
78+
cd taller-ia-agentes-mcp/01-agente-tareas
79+
```
80+
81+
3. Follow the README in that directory for setup instructions
82+
83+
## 📁 Repository Structure
84+
85+
```
86+
codigosinsiesta-examples/
87+
├── taller-ia-agentes-mcp/ # AI Agents & MCP Workshop
88+
│ ├── 01-agente-tareas/ # Task management agent
89+
│ ├── 02-agente-investigador/ # Research agent
90+
│ └── 03-mcp-servers/ # MCP server implementation
91+
├── arquitectura-ia/ # AI Architecture patterns
92+
└── herramientas/ # Tools & utilities
93+
```
94+
95+
## 📖 Documentation
96+
97+
For detailed explanations and tutorials, visit:
98+
99+
- **[Main Site](https://codigosinsiesta.com)** - Home page and latest updates
100+
- **[Documentation](https://codigosinsiesta.com/docs)** - Complete technical documentation
101+
- **[AI Agents Workshop](https://codigosinsiesta.com/docs/proyectos/taller-ia-agentes-mcp/)** - Workshop guide and tutorials
102+
- **[AI Architecture](https://codigosinsiesta.com/docs/categoria/arquitectura-ia)** - Architecture patterns and best practices
103+
- **[Tools & Utilities](https://codigosinsiesta.com/docs/categoria/herramientas)** - Tool development guides
104+
- **[Blog](https://codigosinsiesta.com/blog)** - Latest articles and updates
105+
106+
## 💡 Prerequisites
107+
108+
Most examples require:
109+
110+
- **Node.js** 20.0 or higher
111+
- **npm** or **yarn** package manager
112+
- **API keys** for AI services (Anthropic, OpenAI, etc.)
113+
114+
Specific requirements are listed in each example's README.
115+
116+
## ❓ Need Help?
117+
118+
- **Questions?** Check the [documentation](https://codigosinsiesta.com/docs) first
119+
- **Issues?** Open an [issue](https://github.com/codigosinsiesta/codigosinsiesta-examples/issues) on GitHub
120+
- **Suggestions?** We'd love to hear your ideas!
121+
122+
## 🤝 Contributing
123+
124+
Found a bug or want to improve an example? Contributions are welcome!
125+
126+
1. Fork this repository
127+
2. Create a feature branch
128+
3. Make your changes
129+
4. Submit a pull request
130+
131+
Please ensure your code follows the existing patterns and includes appropriate documentation.
132+
133+
## 📝 License
134+
135+
MIT License - feel free to use these examples in your own projects!
136+
137+
## 🔗 Links
138+
139+
- [Código Sin Siesta Website](https://codigosinsiesta.com)
140+
- [Documentation](https://codigosinsiesta.com/docs)
141+
- [Blog](https://codigosinsiesta.com/blog)
142+
143+
---
144+
145+
Happy coding! 🎉

‎.auto-claude/worktrees/tasks/codigosinsiesta-examples/arquitectura-ia/README.md‎

Lines changed: 64 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,64 @@
1+
# AI Architecture
2+
3+
This section contains examples demonstrating AI system architecture patterns, best practices, and design principles for building production-ready AI applications.
4+
5+
## 📚 What You'll Find Here
6+
7+
Examples covering:
8+
- **System Design Patterns** - Proven architectures for AI applications
9+
- **Scalability Patterns** - Building AI systems that grow with your needs
10+
- **Integration Patterns** - Connecting AI models with your infrastructure
11+
- **Observability** - Monitoring and debugging AI systems
12+
- **Security & Privacy** - Best practices for handling data and API keys
13+
14+
## 🎯 Who Is This For?
15+
16+
These examples are for developers who:
17+
- Want to move beyond prototypes to production AI systems
18+
- Need to integrate AI capabilities into existing applications
19+
- Are building AI-first products and services
20+
- Want to learn architectural best practices
21+
22+
## 🚀 Getting Started
23+
24+
Each example includes:
25+
- **Complete source code** with inline documentation
26+
- **Architecture diagrams** explaining design decisions
27+
- **Setup instructions** to run examples locally
28+
- **Discussion of trade-offs** and alternative approaches
29+
30+
### Prerequisites
31+
32+
Prerequisites vary by example, but commonly include:
33+
- Node.js 20.0 or higher
34+
- Docker (for some examples)
35+
- AI API keys (Anthropic, OpenAI, etc.)
36+
- Basic understanding of system architecture
37+
38+
## 📖 Documentation
39+
40+
For in-depth articles on AI architecture, visit:
41+
- [AI Architecture Guide](https://codigosinsiesta.com/docs/categoria/arquitectura-ia)
42+
- [Main Documentation](https://codigosinsiesta.com/docs)
43+
44+
## 💡 Topics Covered
45+
46+
- Agent orchestration patterns
47+
- Prompt management and versioning
48+
- Error handling and retry strategies
49+
- Cost optimization techniques
50+
- Performance monitoring
51+
- Testing strategies for AI systems
52+
53+
## 🤝 Contributing
54+
55+
Found a bug or have a suggestion? Contributions are welcome!
56+
57+
1. Fork the repository
58+
2. Create a feature branch
59+
3. Make your changes
60+
4. Submit a pull request
61+
62+
---
63+
64+
Happy building! 🏗️

‎.auto-claude/worktrees/tasks/codigosinsiesta-examples/herramientas/README.md‎

Lines changed: 74 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,74 @@
1+
# Tools & Utilities
2+
3+
This section contains practical tool implementations, utilities, and helper libraries that you can use in your AI projects or learn from.
4+
5+
## 📚 What's Included
6+
7+
A collection of:
8+
- **CLI Tools** - Command-line utilities for AI workflows
9+
- **Helper Libraries** - Reusable components and utilities
10+
- **Integration Scripts** - Connect different AI services
11+
- **Development Tools** - Improve your AI development workflow
12+
- **Code Generators** - Automate repetitive tasks
13+
14+
## 🎯 Purpose
15+
16+
These tools serve two purposes:
17+
18+
1. **Educational** - Learn how to build practical tools around AI
19+
2. **Practical** - Use these tools in your own projects
20+
21+
All tools are production-ready and include comprehensive documentation.
22+
23+
## 🚀 Getting Started
24+
25+
Each tool directory contains:
26+
- **README.md** with usage instructions
27+
- **Installation steps** and requirements
28+
- **Examples** of how to use the tool
29+
- **Source code** with inline comments
30+
31+
### General Prerequisites
32+
33+
Most tools require:
34+
- Node.js 20.0 or higher
35+
- npm or yarn
36+
- Relevant API keys (if interacting with AI services)
37+
38+
Specific requirements are listed in each tool's README.
39+
40+
## 📖 Documentation
41+
42+
For articles about building AI tools and utilities:
43+
- [Tools & Utilities Section](https://codigosinsiesta.com/docs/categoria/herramientas)
44+
- [Main Documentation](https://codigosinsiesta.com/docs)
45+
46+
## 💡 Using These Tools
47+
48+
You can use these tools in several ways:
49+
50+
1. **Learn by Example** - Study the code to understand implementation patterns
51+
2. **Use Directly** - Install and use in your projects via npm
52+
3. **Fork and Modify** - Adapt the tools to your specific needs
53+
4. **Contribute** - Help improve existing tools or add new ones
54+
55+
## 🛠️ Available Tools
56+
57+
Check the subdirectories for available tools. Each tool includes:
58+
- Clear documentation
59+
- Installation instructions
60+
- Usage examples
61+
- Configuration options
62+
63+
## 🤝 Contributing
64+
65+
Have a useful tool to share? We'd love to include it!
66+
67+
1. Fork this repository
68+
2. Add your tool in a new directory
69+
3. Include comprehensive README and examples
70+
4. Submit a pull request
71+
72+
---
73+
74+
Happy tooling! 🔧

‎.auto-claude/worktrees/tasks/codigosinsiesta-examples/taller-ia-agentes-mcp/02-agente-investigador/.env.example‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
# Anthropic API Configuration
2+
# Get your API key at: https://console.anthropic.com/settings/keys
3+
ANTHROPIC_API_KEY=your_anthropic_api_key_here

0 commit comments

Comments
 (0)