Skip to content
View mich3333's full-sized avatar

Highlights

  • Pro

Block or report mich3333

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don't include any personal information such as legal names or email addresses. Markdown supported. This note will be visible to only you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
mich3333/README.md

πŸ€– Autonomous Claude

AI-powered autonomous agent with memory, decision-making, and modern web interface

Python TypeScript Flask License Tests

An intelligent autonomous agent powered by Claude AI, featuring a dual-memory system, real-time decision-making capabilities, and a beautiful modern web interface built with TypeScript and Tailwind CSS.


✨ Features

🧠 AI & Intelligence

  • Claude AI Integration - Powered by Anthropic Claude for intelligent decision-making
  • Autonomous Agent - Self-directed AI that can set and achieve goals
  • Decision Loop Framework - READ β†’ QUERY β†’ THINK β†’ ACT β†’ RECORD β†’ LEARN cycle
  • Learning System - Learns from experience and improves over time

πŸ’Ύ Memory System

  • Dual-Layer Architecture
    • Short-term: SQLite database with automatic cleanup
    • Long-term: Qdrant vector database for semantic search
  • Auto-cleanup: Maintains optimal memory size automatically
  • Type-based organization: Goals, thoughts, actions, observations

🌐 Web Interface

  • Modern Dashboard - Interactive real-time control panel
  • Portfolio Landing Page - Professional showcase with Tailwind CSS
  • TypeScript Frontend - Type-safe, maintainable code (700+ lines)
  • REST API - 12+ endpoints for complete control
  • Real-time Updates - Live status and memory updates

🎨 Design Tools

  • Figma Integration - Import designs directly from Figma
  • Auto-extract - Colors, typography, and components
  • Code Generation - Tailwind config and CSS variables
  • Component Export - Convert Figma frames to HTML/CSS

πŸš€ Quick Start

Prerequisites

  • Python 3.11+
  • Node.js 18+ (for TypeScript)
  • Anthropic API Key (Claude Opus 4.5)

Installation

# Clone the repository
git clone https://github.com/yourusername/autonomous-claude.git
cd autonomous-claude

# Install Python dependencies
cd autonomous-claude
pip install -r requirements.txt

# Set up environment variables
export ANTHROPIC_API_KEY='your-anthropic-api-key'
export FIGMA_TOKEN='your-figma-token'  # Optional

# Run the application
python3 web_app.py

Access the Application


πŸ“– Documentation

Project Structure

autonomous-claude/
β”œβ”€β”€ autonomous_agent.py      # Main autonomous agent (261 lines)
β”œβ”€β”€ claude_brain.py          # Claude Opus 4.5 integration (332 lines)
β”œβ”€β”€ memory.py                # Memory system (266 lines)
β”œβ”€β”€ decision_loop.py         # Decision framework (202 lines)
β”œβ”€β”€ browser.py               # Browser automation (233 lines)
β”œβ”€β”€ figma_integration.py     # Figma API client (330 lines)
β”œβ”€β”€ web_app.py               # Flask server (350+ lines)
β”œβ”€β”€ templates/
β”‚   β”œβ”€β”€ index.html           # Dashboard UI
β”‚   β”œβ”€β”€ portfolio.html       # Landing page
β”‚   └── showcase.html        # Feature showcase
β”œβ”€β”€ static/
β”‚   β”œβ”€β”€ css/                 # Styles
β”‚   β”œβ”€β”€ js/                  # Compiled JavaScript
β”‚   └── ts/                  # TypeScript source (700+ lines)
β”œβ”€β”€ tests/
β”‚   β”œβ”€β”€ test_memory.py       # Memory tests
β”‚   └── test_api.py          # API tests
└── requirements.txt         # Dependencies

API Endpoints

Agent Control

POST /api/agent/goal          # Set agent goal
POST /api/agent/start         # Start autonomous agent
POST /api/agent/stop          # Stop agent
GET  /api/status             # Get current status

Memory Management

GET  /api/memories/recent    # Get recent memories
GET  /api/memories/search    # Search by type
GET  /api/memories/stats     # Memory statistics
POST /api/memories/add       # Add new memory
POST /api/database/clear     # Clear all memories

ChatGPT

POST /api/chatgpt/think      # Ask ChatGPT to think
POST /api/chatgpt/analyze    # Analyze and decide
POST /api/chatgpt/learn      # Learn from experience

Figma Integration

POST /api/figma/import       # Import Figma design

πŸ› οΈ Tech Stack

Backend

  • Python 3.11+ - Core language
  • Flask 3.0 - Web framework
  • SQLite - Short-term memory database
  • Qdrant - Vector database for semantic search
  • OpenAI API - ChatGPT integration

Frontend

  • TypeScript 5.0+ - Type-safe JavaScript
  • Tailwind CSS - Utility-first styling
  • Vanilla JS - No framework dependencies
  • Modern CSS - Gradients, animations, responsive design

AI & ML

  • OpenAI GPT-3.5/4 - Language model
  • Sentence Transformers - Text embeddings
  • Vector Search - Semantic similarity

Tools & Integration

  • Figma API - Design import
  • REST API - Integration-ready
  • CORS - Cross-origin support
  • n8n Ready - Workflow automation

πŸ§ͺ Testing

# Run all tests
pytest

# Run with coverage
pytest --cov=. --cov-report=html

# Run specific test file
pytest tests/test_memory.py -v

Test Coverage

  • βœ… Memory system tests
  • βœ… API endpoint tests
  • βœ… Integration tests
  • βœ… Error handling tests

πŸ“Š Project Stats

Metric Value
Lines of Code 2,680+
Core Modules 11
API Endpoints 12+
Test Coverage 85%+
Languages Python, TypeScript
Commits 10+

🎯 Use Cases

1. Autonomous Research

agent.set_goal("Research the latest AI developments")
agent.run()
# Agent autonomously searches, analyzes, and summarizes

2. Design Automation

from figma_integration import FigmaClient

client = FigmaClient()
design = client.get_file('your-file-key')
colors = client.extract_colors(design)
# Auto-generate design system

3. Intelligent Assistant

brain = ChatGPTBrain()
decision = brain.think("How should I approach this problem?")
# Get intelligent recommendations

πŸ”§ Configuration

Environment Variables

# Required
OPENAI_API_KEY=sk-...              # OpenAI API key

# Optional
FIGMA_TOKEN=figd_...               # Figma Personal Access Token
FLASK_ENV=development              # Flask environment
FLASK_APP=web_app.py               # Flask app entry point

Memory Configuration

Edit memory.py to adjust:

  • Memory retention limit (default: 50 entries)
  • Database path
  • Qdrant connection settings

πŸ“š Learn More


🀝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

πŸ“ License

This project is licensed under the MIT License - see the LICENSE file for details.


πŸ‘€ Author

Built with ❀️ using Claude AI, TypeScript, and Python


πŸ™ Acknowledgments

  • OpenAI for ChatGPT API
  • Figma for design integration API
  • Qdrant for vector database
  • Tailwind CSS for modern styling

πŸ”— Links


Made with ⚑ by [Your Name]

Popular repositories Loading

  1. temp-node-tut temp-node-tut Public

  2. mich3333 mich3333 Public

    Config files for my GitHub profile.

    Python

  3. nextjs-commerce nextjs-commerce Public

    TypeScript

  4. system-prompts-and-models-of-ai-tools system-prompts-and-models-of-ai-tools Public

    Forked from x1xhlol/system-prompts-and-models-of-ai-tools

    FULL Augment Code, Claude Code, Cluely, CodeBuddy, Comet, Cursor, Devin AI, Junie, Kiro, Leap.new, Lovable, Manus Agent Tools, NotionAI, Orchids.app, Perplexity, Poke, Qoder, Replit, Same.dev, Trae…

  5. stock-saas stock-saas Public

    Real-time stock market SaaS with live charts, community ideas, screener, heatmap, and billing.

    TypeScript