{"id":13558062,"url":"https://github.com/TileStache/TileStache","last_synced_at":"2025-04-03T12:31:44.335Z","repository":{"id":858304,"uuid":"592276","full_name":"TileStache/TileStache","owner":"TileStache","description":"A stylish alternative for caching your map tiles.","archived":false,"fork":false,"pushed_at":"2024-05-07T08:59:56.000Z","size":5160,"stargazers_count":758,"open_issues_count":140,"forks_count":290,"subscribers_count":39,"default_branch":"master","last_synced_at":"2024-11-04T08:37:14.523Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://tilestache.org","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TileStache.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2010-04-02T20:41:01.000Z","updated_at":"2024-10-17T01:40:29.000Z","dependencies_parsed_at":"2023-01-11T15:48:08.505Z","dependency_job_id":"4743fa1b-3853-4165-850f-b0fd344bc3b2","html_url":"https://github.com/TileStache/TileStache","commit_stats":{"total_commits":1056,"total_committers":97,"mean_commits":10.88659793814433,"dds":0.7537878787878788,"last_synced_commit":"e96532bf59bf79c9991dcc06628f28b27bb19c08"},"previous_names":["migurski/tilestache"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TileStache%2FTileStache","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TileStache%2FTileStache/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TileStache%2FTileStache/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TileStache%2FTileStache/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TileStache","download_url":"https://codeload.github.com/TileStache/TileStache/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247002447,"owners_count":20867464,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-01T12:04:43.225Z","updated_at":"2025-04-03T12:31:39.321Z","avatar_url":"https://github.com/TileStache.png","language":"Python","funding_links":[],"categories":["Python","others","Servers"],"sub_categories":[],"readme":"# TileStache\n\n_a stylish alternative for caching your map tiles_\n\n[![Build Status](https://api.travis-ci.org/TileStache/TileStache.svg?branch=master)](https://travis-ci.org/TileStache/TileStache)\n\n**TileStache** is a Python-based server application that can serve up map tiles\nbased on rendered geographic data. You might be familiar with [TileCache](http://tilecache.org),\nthe venerable open source WMS server from MetaCarta. TileStache is similar, but we hope\nsimpler and better-suited to the needs of designers and cartographers.\n\n## Synopsis\n\n    import TileStache\n    import ModestMaps\n\n    config = {\n      \"cache\": {\"name\": \"Test\"},\n      \"layers\": {\n        \"example\": {\n            \"provider\": {\"name\": \"mapnik\", \"mapfile\": \"examples/style.xml\"},\n            \"projection\": \"spherical mercator\"\n        }\n      }\n    }\n\n    # like http://tile.openstreetmap.org/1/0/0.png\n    coord = ModestMaps.Core.Coordinate(0, 0, 1)\n    config = TileStache.Config.buildConfiguration(config)\n    type, bytes = TileStache.getTile(config.layers['example'], coord, 'png')\n\n    open('tile.png', 'w').write(bytes)\n\n\n\n## Dependencies\n\n### Required:\n\n- ModestMaps: http://modestmaps.com, http://github.com/migurski/modestmaps-py\n- Python Imaging Library (Pillow): https://python-pillow.org\n\n### Optional:\n\n- Simplejson: https://github.com/simplejson/simplejson (optional if using \u003e= python 2.6)\n- mapnik: http://mapnik.org (optional)\n- werkzeug: http://werkzeug.pocoo.org/ (optional)\n- mapbox-vector-tile: https://github.com/tilezen/mapbox-vector-tile (optional if using TileStache.Goodies.VecTiles:Provider)\n\nInstall the pure python modules with pip:\n\n    sudo pip install -U pillow modestmaps simplejson werkzeug uuid mapbox-vector-tile\n\nInstall pip (http://www.pip-installer.org/) like:\n\n    curl -O -L https://bootstrap.pypa.io/get-pip.py\n    sudo python get-pip.py\n\nInstall Mapnik via instructions at:\n\n    http://mapnik.org/pages/downloads.html\n\n\n## Installation\n\nTileStache can be run from the download directory as is. For example the scripts:\n\n    tilestache-render.py tilestache-seed.py tilestache-server.py\n\nCan all be run locally like:\n\n    ./scripts/tilestache-server.py\n\nTo install globally do:\n\n    python setup.py install\n\n  * Note: you may need to prefix that command with 'sudo' to have permissions\nto fully install TileStache.\n\n\n## Quickstart\n\nTo make sure TileStache is working start the development server:\n\n    ./scripts/tilestache-server.py\n\nThen open a modern web browser and you should be able to preview tiles at:\n\n    http://localhost:8080/osm/preview.html\n\nThis is a previewer that uses ModestMaps and OpenStreetMap tiles from\nhttp://tile.osm.org as defined in the default config file 'tilestache.cfg'\n\n\n## Documentation\n\nThe next step is to learn how build custom layers and serve them.\n\nSee the [docs](http://tilestache.org/doc/) for details.\n\n\n## Features\n\nRendering providers:\n* Mapnik\n* Proxy\n* Vector\n* Templated URLs\n\nCaching backends:\n* Local disk\n* Test\n* Memcache\n* S3\n\n\n## Design Goals\n\nThe design of TileStache focuses on approachability at the expense of\ncleverness or completeness. Our hope is to make it easy for anyone to design\na new map of their city, publish a fresh view of their world, or even build\nthe next 8-Bit NYC (http://8bitnyc.com).\n\n* Small\n\nThe core of TileStache is intended to have a small code footprint.\nIt should be quick and easy to to understand what the library is doing and\nwhy, based on common entry points like included CGI scripts. Where possible,\ndynamic programming \"magic\" is to be avoided, in favor of basic, procedural\nand copiously-documented Python.\n\n* Pluggable\n\nWe want to accept plug-ins and extensions from outside TileStache, and offer\nTileStache itself as an extension for other systems. It must be possible to\nwrite and use additional caches or renderers without having to modify the\ncore package itself, extend classes from inside the package, or navigate\nchains of class dependencies. Duck typing and stable interfaces win.\n\n* Sensible Defaults\n\nThe default action of a configured TileStache instance should permit the most\ncommon form of interaction: a worldwide, spherical-mercator upper-left oriented\ntile layout compatible with those used by OpenStreetMap, Google, Bing Maps,\nYahoo! and others. It should be possible to make TileStache do whatever is\nnecessary to support any external system, but we eschew complex, impenetrable\nstandards in favor of pragmatic, fast utility with basic web clients.\n\n\n## License\n\nBSD, see LICENSE file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FTileStache%2FTileStache","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FTileStache%2FTileStache","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FTileStache%2FTileStache/lists"}