SerpentAI  by SerpentAI

Game agent framework for creating bots

Created 8 years ago
6,928 stars

Top 7.4% on SourcePulse

GitHubView on GitHub
Project Summary

SerpentAI is a Python framework for creating AI agents that learn to play video games, targeting AI researchers and hobbyists. It provides a flexible, plugin-based sandbox for experimenting with various AI techniques, from deep reinforcement learning to computer vision, without requiring specific game APIs or proprietary environments.

How It Works

SerpentAI acts as a bridge between a game and an AI agent, capturing game state (e.g., screen pixels, memory) and translating agent actions (e.g., key presses) into game inputs. Its plugin architecture allows for easy integration of new games and agent algorithms, promoting portability and community sharing. The framework emphasizes native execution and user-provided games, avoiding dependencies on Docker or VNC.

Quick Start & Requirements

  • Install via pip install serpentai.
  • Requires Python 3.8+.
  • Supports Linux and Windows. macOS support is deprecated.
  • Official documentation is available on the GitHub Wiki.

Highlighted Details

  • Supports diverse AI approaches: deep reinforcement learning, computer vision, image processing, trigonometry.
  • Plugin-based design for game support and agents, enabling portability and distribution.
  • Aims for ease of use with an installer and GUI in future versions.
  • Revival in May 2020 targets Python 3.8+, reduced dependencies, and improved usability.

Maintenance & Community

Licensing & Compatibility

  • Permissive license (details not specified in README, but implied to be suitable for commercial use and closed-source linking).

Limitations & Caveats

  • macOS support is officially deprecated due to reliance on CUDA and Apple's hardware/software ecosystem decisions.
  • The framework is described as "simple yet powerful," but the extent of its capabilities and stability for complex games is not detailed.
Health Check
Last Commit

2 years ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
0
Star History
15 stars in the last 30 days

Explore Similar Projects

Starred by Justin Spahr-Summers Justin Spahr-Summers(Cocreator of Model Context Protocol; MTS at Anthropic), Jason Knight Jason Knight(Director AI Compilers at NVIDIA; Cofounder of OctoML), and
5 more.

mindcraft by mindcraft-bots

0.7%
4k
LLM agent for Minecraft
Created 2 years ago
Updated 1 day ago
Starred by Wes McKinney Wes McKinney(Author of Pandas), Chip Huyen Chip Huyen(Author of "AI Engineering", "Designing Machine Learning Systems"), and
22 more.

autogen by microsoft

0.5%
50k
Agentic framework for multi-agent AI applications
Created 2 years ago
Updated 18 hours ago
Feedback? Help us improve.