{"id":23116,"library":"kiss-icp","title":"KISS-ICP","description":"KISS-ICP is a simple yet effective LiDAR odometry pipeline for real-time 3D registration. Version 1.3.0 is currently released on PyPI with Python 3.8+ support. The library is in active development with periodic releases.","status":"active","version":"1.3.0","language":"python","source_language":"en","source_url":"https://github.com/PRBonn/kiss-icp","tags":["lidar","odometry","registration","3d","slam","robotics"],"install":[{"cmd":"pip install kiss-icp","lang":"bash","label":"Basic install"},{"cmd":"pip install kiss-icp[all]","lang":"bash","label":"Install with all dependencies (ros2, viz)"}],"dependencies":[],"imports":[{"note":"","wrong":"","symbol":"kiss_icp","correct":"import kiss_icp"},{"note":"The recommended API is top-level; the old submodule path may break.","wrong":"from kiss_icp.registration import Registration","symbol":"Registration","correct":"from kiss_icp import Registration"},{"note":"KissICP is in the pipeline module, not top-level.","wrong":"from kiss_icp import KissICP","symbol":"KissICP","correct":"from kiss_icp.pipeline import KissICP"},{"note":"VoxelHashMap is in the voxel_map submodule.","wrong":"from kiss_icp import VoxelHashMap","symbol":"VoxelHashMap","correct":"from kiss_icp.voxel_map import VoxelHashMap"}],"quickstart":{"code":"import kiss_icp\nfrom kiss_icp.pipeline import KissICP\n\nconfig = kiss_icp.config.KISSConfig()\npipeline = KissICP(config)\n\n# Example registration of a single frame\nimport numpy as np\nframe = np.random.rand(100, 3).astype(np.float64)  # replace with actual LiDAR frame\npose = pipeline.register_frame(frame)\nprint(pose)","lang":"python","description":"Minimal example to set up the pipeline and register a frame."},"warnings":[{"fix":"Update any scripts or configurations that set environment variables to use the new prefix (e.g., KISS_ICP_MAX_RANGE -> KISS_ICP_MAX_RANGE still same, but check new names).","message":"In v1.0.0, environment variables were renamed from 'KISS_ICP_*' to 'KISS_ICP_*' (prepended with 'kiss_icp_')","severity":"breaking","affected_versions":"<1.0.0"},{"fix":"Use 'from kiss_icp.pipeline import KissICP' and consult the updated documentation.","message":"In v1.0.0, the Python API changed significantly. The old top-level import 'from kiss_icp import KissICP' may no longer work.","severity":"breaking","affected_versions":"<1.0.0"},{"fix":"For ARM, upgrade to v1.3.0 or install from source with a C++ compiler.","message":"The library uses C++ extensions and may require a C++ compiler on first install, especially on ARM systems (before v1.3.0). v1.3.0 improved ARM support via pip.","severity":"gotcha","affected_versions":"<1.3.0"},{"fix":"Use the ros2 extra: pip install kiss-icp[ros2]","message":"ROS 1 support was dropped in v0.4.0. Use ROS 2 wrapper instead.","severity":"deprecated","affected_versions":">=0.4.0"},{"fix":"Replace .dict() calls with .model_dump() on config objects.","message":"Pydantic models changed from .dict() to .model_dump() in recent versions. If you use custom configs, update accordingly.","severity":"gotcha","affected_versions":">=0.4.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run 'pip install kiss-icp' in the correct Python environment.","cause":"Library not installed or installed in wrong environment.","error":"ModuleNotFoundError: No module named 'kiss_icp'"},{"fix":"Use 'from kiss_icp.pipeline import KissICP' instead of 'from kiss_icp import KissICP'.","cause":"Wrong import path for the pipeline class.","error":"ImportError: cannot import name 'KissICP' from 'kiss_icp'"},{"fix":"Replace .dict() with .model_dump() on config objects. Example: config.model_dump()","cause":"Pydantic v2 change: .dict() removed in favor of .model_dump().","error":"AttributeError: 'KISSConfig' object has no attribute 'dict'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}